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1. Amiga Basic - Eine Übersicht 


Erst wenn Sie die Möglichkeit haben, das Geschehen auf dem Bildschirm Ihres 
Amiga zu beeinflussen, können Sie erfolgreich mit dem Computer arbeiten. Zwar 
erlauben die meisten Computeranwendungen, seien es kommerzielle Programme 
oder Spiel-Programme, ein gewisses Maß an Ablaufsteuerung durch den Anwen¬ 
der. Um jedoch die gesamte Leistungsfähigkeit und Flexibilität eines Computersy¬ 
stems wie des Amiga ausnutzen zu können, bedarf es einer Programmiersprache. 

Ihr Amiga ist eine außergewöhnliche Maschine! Damit Sie sich deren Eigenschaf¬ 
ten nutzbar machen können, haben wir eine außergewöhnliche Programmierspra¬ 
che entwickelt, das Amiga Basic. 

Amiga Basic enthält natürlich alle Funktionen des Standardbefehlsumfanges 
gängiger Basic-Dialekte. 

Zusätzlich erlaubt es Ihnen jedoch auch Zugriff auf die superschnelle Grafik sowie 
auf Tonerzeugung und Sprachsynthetisierung und viele weitere Besonderheiten 
des Amiga. 

Warum Basic? 

Da die Basic-Befehle in englischem Klartext formuliert werden, ist diese Program¬ 
miersprache leicht zu lernen und anzuwenden. Wegen der übergroßen Popularität 
von Basic haben die meisten Menschen, also vielleicht auch Sie, die sich schon 
einmal mit Computern beschäftigt haben, bereits einiges von Basic gehört. 

Das bedeutet aber, daß Sie ohne große Mühe sehr schnell Ihre eigenen Program¬ 
me in Amiga Basic schreiben und ausprobieren können. 

Sind Sie ein Anfänger, so werden Sie natürlich zunächst die einfachen Amiga 
Basic-Operationen ausprobieren. Sie brauchen keine Angst vor Programmierfeh¬ 
lern zu haben. Amiga Basic sagt Ihnen sofort, was Sie falsch gemacht haben und 
Ihr Amiga nimmt Ihnen keinen Programmierfehler übel. 

Sobald Sie über etwas Programmiererfahrung verfügen, werden Sie sicherlich all 
die interessanten Möglichkeiten, die der Amiga bietet, ausprobieren wollen. Dafür 
stellt Amiga Basic einen eindrucksvollen Satz von Programmierhilfsmitteln zur 
Verfügung und erlaubt zusätzlich den Zugriff auf die residenten Amiga-Biblio- 
theksroutinen des Betriebssystems sowie selbst geschriebene Maschinenspra¬ 
che-Unterprogramme. 
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Über dieses Handbuch 

Dieses Handbuch gliedert sich in 9 Kapitel. 

Kapitel 1 enthält eine kurze Einleitung, eine Übersicht über den Aufbau des 
Handbuches und die Besonderheiten des Amiga Basic-Interpreters. 

Kapitel 2 beschreibt anhand eines Programm-Beispiels detailliert die Arbeitswei¬ 
se des Amiga Basic-Interpreters. 

Kapitel 3 behandelt die Grundlagen der Arbeit mit Amiga Basic, seine Betriebsar¬ 
ten sowie den Bildschirm. 

Kapitel 4 beschreibt das Edieren und Testen von Amiga Basic-Programmen. 

Kapitel 5 enthält eine Beschreibung der Datei-Ein-/Ausgabe mit Amiga Basic. 

Kapitel 6 beschäftigt sich mit Unterprogrammen, Unterbrechungsverarbeitung 
und Speicherverwaltung. 

Kapitel 7 beschreibt das Erzeugen bewegter Bilder mit dem Objekt-Editor des 
Amiga Basic. 

Kapitel 8 behandelt die Elemente des Amiga Basic wie Zeichensatz, Sprungmar¬ 
ken, Konstanten, Variablen, Ausdrücke und Operatoren. 

Kapitel 9 enthält das alphabetische Verzeichnis aller Befehle, Anweisungen, 
Funktionen und Systemvariablen sowie deren Beschreibung und stellt damit den 
Hauptteil dieses Handbuches dar. 

Anhang A enthält die ASCII-Code-Zeichentabelle. 

Anhang B enthält eine Zusammenstellung aller Fehler-Codes und -Meldungen. 

Anhang C beinhaltet eine Tabelle der reservierten Worte des Amiga Basic-Inter¬ 
preters. 

Anhang D beschreibt die interne Darstellung von Zahlen. 

Anhang E enthält Umschreibungen der transzendenten Funktionen mit vorhande¬ 
nen Amiga Basic-Funktionen. 
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Anhang F enthält Informationen, wie eine Bibliothek von Maschinensprache-Un¬ 
terprogrammen für Amiga Basic-Programme aufgebaut werden kann. 

Anhang G beschreibt noch einmal detailliert das in Kapitel 2 verwendete Beispiel¬ 
programm. 

Anhang H schließlich behandelt ausführlich die Grundlagen der Sprach-Syntheti- 
sierung und die Nutzung der entsprechenden Einrichtungen des Amiga zur 
Ausgabe künstlicher Sprache. 


1.1 Spezielle Eigenschaften von Amiga Basic 


Der Amiga Basic-Interpreter ist vollständig in der Assemblersprache für den 
Mikroprozessor MC68000 geschrieben und belegt deshalb gemessen an seiner 
Leistungsfähigkeit einen relativ kleinen Teil des Speichers (ca. 80 KBytes). Der 
Kern des Interpreters wurde über einen Zeitraum von 3 Jahren intensiv in der 
Praxis getestet. Amiga Basic ist insofern ein Standard-Basic, als damit die 
meisten in Standard-Microsoft- oder GW-Basic für andere Rechner geschriebe¬ 
nen Programme bearbeitet werden können. 


Vereinfachung der Programmentwicklung 

Wie jede andere Programmiersprache auch wird Amiga Basic ständig erwei¬ 
tert, verändert und verbessert, um auch neue Rechnereigenschaften zu 
berücksichtigen. Im folgenden sind einige der besonderen Eigenschaften des 
Amiga, die von Amiga Basic unterstützt werden, zusammengestellt. Eine 
detaillierte Beschreibung finden Sie in Kapitel 9. 


Unterstützung für Amiga-Anwendersoftware 

Amiga Basic stellt ihnen Hilfsmittel zur Verfügung, die Sie benötigen, um 
Basic-Programme zu schreiben, die so ablaufen wie professionelle, speziell 
für den Amiga erstellte Software. Diese Hilfsmittel sind für Software-Entwick¬ 
ler eine große Unterstützung, die Anwendersoftware erstellen und verkaufen 
wollen. 
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Außerdem können bekannte Programme, die in den Basic-Dialekten für 
Macintosh- *) oder IBM-PC *)-Rechner erstellt wurden, ohne große Proble¬ 
me auf den Amiga übertragen werden. 


Unterstützung der Maus 

Mit der MOUSE-Funktion (s. Kapitel 9) kann Ihr Basic-Programm Maus-Betä¬ 
tigungen verarbeiten und darauf reagieren. Sie liefert die Bildschirm-Koordi¬ 
naten des Maus-Zeigers unter den verschiedensten Bedingungen (Auswahl- 
tasten-Zustand und -Betätigung, Ziehen von Objekten). 


MENU-Anweisung 

Mit der MENU-Anweisung (s. Kapitel 9) können Sie die charakteristischen 
Amiga-Menüs erzeugen, öffnen, schließen und gewählte Menü-Punkte her¬ 
vorheben, um damit Ihren Programmen ein professionelles Aussehen zu 
verleihen. 


1.2 Leistungsfähige Sprach-Besonderheiten 


Der Amiga Basic-Interpreter stellt eine Reihe von äußerst leistungsfähigen 
Besonderheiten zur Verfügung, die Ihren Programmen große Flexibilität verleihen. 
Dazu gehören: 


Anweisungsblöcke 

Mit Hilfe der IF-THEN-ELSE-Anweisung (s. Kapitel 9) können Sie program¬ 
mierte Entscheidungen während des Programmablaufes treffen. Sie können 
nach der THEN-Klausel eine oder mehrere Anweisungen in einer oder auch 
mehreren Programmzeilen angeben und damit Ihr Programm übersichtlich 
strukturieren. 


) Markenzeichen der Firmen Apple bzw. IBM 
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Unterprogramme 

Amiga Basic erlaubt Unterprogramme mit lokalen Variablen. Mit Hilfe von 
Unterprogrammen können Sie sich Ihre eigene Bibliothek von Basic-Pro- 
grammbausteinen aufbauen, die sie bei verschiedenen Amiga Basic-Pro- 
grammen einsetzen können. Dabei brauchen Sie keine Probleme wegen 
gleicher Variablennamen im Haupt- und Unterprogramm zu befürchten. 


Globalisierung lokaler Variablen mit der SHARED-Anweisung 

Umgekehrt können Sie aber auch Variablen in einem Unterprogramm als 
globale Variablen deklarieren, um so die Übergabe von Werten zwischen 
Haupt- und Unterprogramm zu erleichtern. 


Ganzzahl-Arithmetik 

Amiga Basic unterstützt sowohl 16-als auch 32-Bit-Ganzzahl-Arithmetik. 


Gleitpunkt-Arithmetik 

Gleitpunkt-Arithmetik kann mit 32 oder 64 Bit durchgeführt werden, um große 
Rechengenauigkeit zu erzielen. 


Programme ohne Zeilennummern 

Amiga Basic-Programme benötigen keine Zeilennummern mehr. Durch Zu¬ 
ordnen alphanumerischer oder numerischer Sprungmarken können Sie struk¬ 
turierte Programme erstellen, die sich durch große Übersichtlichkeit auszeich¬ 
nen. 


Unterstützung von sequentiellen und Direktzugriffs-Dateien 

Sie können mit Amiga Basic sowohl sequentielle als auch Direktzugriffs-Da¬ 
teien auf Diskette oder Festplatte erzeugen. Erstere sind leichter zu handha¬ 
ben, letztere erlauben einen wesentlich schnelleren Datenzugriff. 
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Geräteunabhängige Ein-/Ausgabe 

Mit Hilfe der üblichen Datei-Ein-/Ausgabe-Anweisungen des Amiga Basic- 
Interpreters kann ein Programm die Daten-Ein-/Ausgabe an den Bildschirm, 
von der Tastatur, an den Drucker oder über die RS232- oder Parallel-Schnitt- 
stelle umleiten. Sie können den Drucker oder Bildschirm für Datenausgabe 
ebenso einfach öffnen, wie Sie eine Disk-Datei öffnen. 


1.3 Unterstützung der besonderen Amiga-Möglichkeiten 


Eine Reihe von Besonderheiten des Amiga Basic-Interpreters machen Gebrauch 

von den einzigartigen grafischen und akustischen Möglichkeiten des Amiga: 

• Synchronisierte 4-Kanal-Musikwiedergabe mit den SOUND- und WAVE-An- 
weisungen. 

• Erzeugung verständlicher Sprache mit der SAY-Anweisung und der TRANS- 
LATE$-Funktion. 

• Speichern und Wiedergewinnen von grafischen Objekten mit den GET- und 
PUT-Anweisungen. 

• Vollständiger Satz grafischer Anweisungen: LINE, CIRCLE, PAINT, PUT, GET, 
AREA, AREAFILL. 

• Weitgehende Unterstützung grafischer Animation (Bewegen grafischer Ob¬ 
jekte) mit den OBJECT-Anwisungen, dem Objekt-Editor und der COLLI- 
SION-Funktion. 

• Verwaltung und Aufruf von Maschinensprache-Unterprogrammen mit Hilfe 
der LIBRARY- und DECLARE FUNCTION-Anweisungen. 

• Öffnen und Bedienen mehrerer Bildschirme und Fenster mit den SCREEN- 
und WINDOW-Anweisungen. 

• Erstellung und Benutzung von Abroll-Menüs (pull-down menus) mit Hilfe der 
MENU-Anweisung. 
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Alle diese Anweisungen werden detailliert in Kapitel 9 beschrieben. Der Objekt-E¬ 
ditor wird in Kapitel 7 behandelt. Im folgenden wird für einige der genannten 
Anweisungen eine kurze Übersicht gegeben. 


Klangerzeugung mit SOUND und WAVE 

Sie können mit Amiga Basic-Programmen Klänge hoher Tonqualität für Spiele 
und Musikprogramme erzeugen, oder auch Anwender-Warnmeldungen aus¬ 
geben. Die SOUND-Anweisung gibt einen Ton wählbarer Frequenz, Dauer 
und Lautstärke aus. Zusätzlich kann noch zwischen 4 verschiedenen Tonka¬ 
nälen gewählt werden. Jedem dieser Tonkanäle können Sie mit Hilfe der 
WAVE-Anweisung Ihre eigene, vielleicht komplexe, Wellenform zuordnen. Mit 
Hilfe dieser beiden Anweisungen können Sie Ihre Programme mit Musik von 
der Komplexität eines Streichquartetts bis zu der Simplizität eines Pfeiftones 
ausstatten. 


Figuren zeichnen mit LINE und CIRCLE 

LINE und CIRCLE sind vielseitige Anweisungen zur Erzeugung präziser 
grafischer Darstellungen. Mit der LINE-Anweisung können Sie eine Linie 
zwischen zwei Punkten mit absoluten oder relativen Koordinaten zeichnen. 
Mit Hilfe der B-Option für die LINE-Anweisung können Sie ein Rechteck oder 
Quadrat Zeichen, das Sie auch noch mit einer beliebigen Farbe ausfüllen 
können (BF-Option). 

Mit der CIRCLE-Anweisung lassen sich Ellipsen, Kreise oder Kreisbögen mit 
wählbarem Mittelpunkt und Radius zeichnen, optional auch in Farbe. Durch 
Veränderung der Aspekt-Option (Verhältnis von Bildbreite zu Bildhöhe) kann 
man die verschiedensten Ellipsen erzeugen. 


Grafische Bildverarbeitung mit GET, PUT und SCROLL 

Mit der GET-Anweisungen können Ansammlungen von Bildpunkten auf dem 
Bildschirm in ein Feld übertragen werden. Auf diese Weise lassen sich 
Grafiken schnell in den Hauptspeicher des Rechners übertragen. 


Mit der PUT-Anweisung lassen sich mit GET gespeicherte Bilder wieder auf 
dem Bildschirm darstellen. 
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Mit der SCROLL-Anweisung legen Sie fest, welcher Bildschirmbereich um 
welchen Betrag in welche Richtung auf-, ab-, hin- oder hergerollt werden soll. 


Der Objekt-Editor 

Mit dem Objekt-Editor, einem in Amiga Basic geschriebenen Programm, 
können Sie grafische Objekte für die Animation in Spielprogrammen zeichnen. 
Kapitel 7 enthält Einzelheiten. 
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2. Mit Amiga Basic vertraut werden 


Dieses Handbuch geht davon aus, daß Sie mit den Grundfunktionen des Amiga 
und dem Arbeiten am Arbeitstisch (Workbench) vertraut sind. Wenn nicht, 
verschaffen Sie sich die notwendige Übung mit Hilfe des Amiga-Benutzerhandbu- 
ches. 

Um mit Amiga Basic arbeiten zu können, benötigen Sie: 

• einen Amiga-Computer, betriebsbereit zusammengeschaltet, 

• die Amiga Extras-Diskette zusätzlich zur Kickstart- und Workbench-Dis- 
kette. 

Ehe Sie mit der Arbeit beginnen, sollten Sie sich von der Amiga Extras-Diskette 
zwei Sicherungskopien anfertigen. 

Der Start von Amiga Basic geht in folgenden vier Schritten vor sich: 

• Schalten Sie den Computer und den Monitor ein. Sobald Sie zum Einlegen der 
Kickstart-Diskette aufgefordert werden, legen Sie diese in das eingebaute 
Laufwerk ein. 

• Nach wenigen Augenblicken werden Sie zum Einlegen der Workbench-Dis- 
kette aufgefordert. Legen Sie sie anstelle der Kickstart-Diskette ein und 
warten Sie, bis Sie das Piktogramm der Workbench-Diskette auf dem 
Bildschirm sehen und die Laufwerk-Kontrollampe erloschen ist. 

• Legen Sie jetzt die Amiga Extras-Diskette in ein beliebiges Laufwerk, falls Sie 
über mehrere verfügen, sonst in das eingebaute Laufwerk. 

• Sobald das Extras-Piktogramm auf dem Bildschirm erscheint, öffnen Sie es 
und öffnen Sie dann in dem Fenster das Amiga Basic-Piktogramm. 

Nach wenigen Sekunden sehen Sie den Amiga Basic-Bildschirm. 

Beachten Sie In diesem Abschnitt wird davon ausgegangen, daß der Amiga 
Basic-Bildschirm die Originalfarben des Arbeitstisches (blauer Hintergrund, wei¬ 
ßer Vordergrund, orange und schwarz als zusätzliche Farben) zeigt. 
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Zu diesem Zeitpunkt erscheint der Text-Cursor, ein vertikaler orangefarbener 
Strich im List-Fenster, dem rechten der beiden auf dem Amiga Basic-Bildschirm 
dargestellten Fenster. Der Text-Cursor gibt die Position im Fenster an, bei der das 
nächste auf der Tastatur eingebene Zeichen abgebildet wird. Sie können im 
List-Fenster entweder ein neues Programm eingeben oder ein existierendes 
weiter bearbeiten und ändern, wie Sie im nächsten Abschnitt noch sehen werden. 
Die Titelleiste im List-Fenster wird ausgeprägt dargestellt, um zu zeigen, daß 
dieses Fenster ausgewählt, also aktiv ist, während die Titelleiste im Ausgabe- 
Fenster (das linke, mit BASIC betitelte Fenster) in Geisterschrift dargesteilt ist, um 
zu zeigen, das dieses Fenster inaktiv ist. 

Das Ausgabe-Fenster von Amiga Basic zeigt Ihnen nicht nur die Ergebnisse eines 
Programms an, sondern erlaubt Ihnen auch die direkte Eingabe und das Ausfüh¬ 
ren von Basic-Befehlen. Sie können zu jeder Zeit, wenn Sie Befehle direkt 
ausführen lassen wollen, die Titelleiste des Ausgabe-Fensters wählen. Amiga 
Basic quittiert dies mit der Ok-Anzeige und stellt den Text-Cursor bereit. 

Um die Menü-Titel in der Menü-Leiste darzustellen, wählen Sie das Ausgabe- 
Fenster und halten dann die Menü-Taste der Maus (die rechte Taste) gedrückt. 

So sieht also der Amiga Basic-Bildschirm aus: 



Hindergrundsymbol 

Vordergrundsymbol 

Menü-Leiste 

Titel-Leiste 

Ausgabe-Fenster 
gewähltes Fenster 
List-Fenster 


Größen-Symbol 
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2.1 Ein praktisches Beispiel 


Sie können jetzt durch die Bearbeitung eines praktischen Beispiels mit dem 
Amiga Basic-Interpreter vertraut werden. 

Um den Inhalt der Amiga Extras-Diskette anzuzeigen, 

• wählen Sie das Ausgabe-Fenster, 

Wenn die Ok-Bereitschaftsanzeige erscheint, 

• geben Sie ein: 


und 

• drücken Sie die RETURN-Taste. 

Sie sehen jetzt im Ausgabe-Fenster eine Liste mit Datei- und Verzeichnisnamen. 
Das Fenster füllt sich und der Inhalt wird dann zeilenweise nach oben gerollt, je 
mehr Informationen angezeigt werden. Um das Aufrollen anzuhalten, drücken Sie 
die rechte Amiga-Taste zusammen mit derS-Taste. Zur Fortsetzung drücken Sie 
jede beliebige Taste. 

Um die Dateien in einem der Verzeichnisse anzuzeigen, geben Sie den Befehl files 
gefolgt von dem gewünschten Verzeichnisnamen, in Anführungsstriche (“) einge¬ 
kleidet, ein. Befindet sich die betreffende Diskette in einem externen Laufwerk, so 
muß vor dem Verzeichnisnamen noch die Laufwerksbezeichnung angegeben 
werden. Wenn sich z.B. die Extras-Diskette im Laufwerk 1 befindet, listet der 
folgende Befehl alle Dateien des Verzeichnisses BasicDemos: 


Files”df1:basicdemns" 
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Das Programm Picture laden 

Beginnen Sie jetzt, indem Sie das Programm Picture laden, das in der 
BasicDemos-Ablage (oder -Verzeichnis) gespeichert ist. Picture ist ein in 
Amiga Basic geschriebenes kleines Demonstrationsprogramm: 

• Drücken Sie die Menütaste der Maus und zeigen Sie auf den Menü-Titel 
Project in der Menü-Leiste. Es werden die Menü-Punkte New, Open, 
Close, Save, Save As und Quit angezeigt. 

• Wählen Sie Open. 



Im Ausgabe-Fenster wird ein Kommunikationsfenster eingeblendet. 

• Wählen Sie das Symbolfeld “Name of program to load“ (Name des zu 
ladenden Programms) 

• Geben Sie ein: 


BasicDemos/Picture 


• Wählen Sie das Symbolfeld OK oder drücken Sie die RETURN-Taste. 


Nähere Informationen zur Schreibweise von Datei- und Verzeichnisnamen 
finden Sie im Kapitel 5.2 sowie im AmigaDOS-Benutzerhandbuch. 
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Die Programmliste des Programms Picture Sobald das Programm geladen 
ist, wird es im List-Fenster aufgelistet. Der Name des Ausgabe-Fensters 
ändert sich von BASIC in Basic Demos/Picture. 

Vielleicht haben Sie erwartet, daß jede Programmzeile mit einer Zeilennummer 
beginnt. Amiga Basic benötigt keine Zeilennummern, akzeptiert sie aber, 
wenn sie vorhanden sind. Um auf eine bestimmte Zeile Bezug zu nehmen, 
brauchen Sie dieser Zeile nur eine Sprungmarke oder eine Nummer voranzu¬ 
stellen. Das Picture-Programm hat, wie Sie sehen können, keine Zeilennum¬ 
mern, dafür aber zwei Sprungmarken: CheckMouse und MovePicture: 



Sprungmarken 


Sprungmarken und Zeilennummern stellen Einsprung-Punkte für GOTO- 
oder GOSUB-Anweisungen in anderen Programmteilen dar. 

• Wählen Sie jetzt das Ausgabe-Fenster und geben Sie ein: 


1 ist CheckMouse 


• Drücken Sie die RETURN-Taste. 


Sie sehen, daß der Inhalt des List-Fensters bis zu der Sprungmarke Check¬ 
Mouse: aufgerollt wird. Wenn Sie jetzt im List-Fenster edieren wollen, müssen 
Sie es zuerst wählen. 

Reservierte Worte in Großschrift Amiga Basic-Programme sind auf dem 
Bildschirm leicht zu lesen, weil die reservierten Wörter, also die Basic-Schlüs- 
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selwörter, automatisch in Großschrift umgewandelt werden. Andere Teile wie 
Variablen- und Sprungmarken-Namen bleiben so, wie sie eingegeben 
wurden: 


Reservierte 
Amiga-Basic- 
Wörter werden 
in Großschrift 
dargestellt 

Andere Wörter 
werden wie 
angegeben 
dargstellt. 


Beachten Sie, daß die reservierten Wörter erst in Großschrift angezeigt 
werden, wenn Sie die Zeilen anzeigen, nicht schon bei der Eingabe. 

Was das Programm Picture macht 

Starten Sie jetzt das Programm wie folgt: 


• Um das Ausgabe-Fenster über dem List-Fenster zu öffnen, wählen Sie 
Show Output Window (zeige Ausgabe-Fenster) aus dem Windows-Menü. 
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• Wählen Sie Start aus dem Run-Menü. 

Im Ausgabe-Fenster erscheint jetzt das Programm-Ergebnis: die strukturier¬ 
te Darstellung eines Ellipsoids. Dieses Bild können Sie über den Bildschirm 
bewegen, indem Sie die Auswahltaste der Maus irgendwo im Ausgabe-Fen¬ 
ster drücken. Versuchen Sie es einmal. 



Die Ausgabe 
von Picture 


Das Programm anhalten 

Das Programm Picture läuft solange, bis Sie es anhalten. 

• Wählen Sie Stop aus dem Run-Menü. 

• Wählen Sie Show List Window (List-Fenster zeigen) aus dem Windows- 
Menü. Damit wird das List-Fenster in den Vordergrund gebracht. Um das 
Programm im List-Fenster edieren zu können, müssen Sie dieses Fenster 
zuerst wählen. 


Cursor-Bewegungen im List-Fenster 

Um den Text-Cursor im List-Fenster von einer Zeile zur anderen zu bewegen, 
drücken Sie innerhalb dieses Fensters die Auswahltaste der Maus und 
drücken Sie dann eine der Vertikal-Pfeiltasten rechts unten auf der Tastatur. 
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Um den Cursor innerhalb einer Zeile nach rechts oder links zu bewegen, 
drücken Sie eine der Horizontal-Pfeiltasten rechts unten auf der Tastatur. 

Um das ganze Programm fensterweise zu durchblättern, drücken Sie eine der 
Vertikal-Pfeiltasten zusammen mit der SHIFT-Taste. 

Beachten Sie : Wann immer Sie im weiteren Verlauf dieses Handbuches auf die 
Bezeichnung zweier Tasten, verbunden mit einem Bindestrich stoßen, wie z.B. 
SHIFT-Pfeil nach oben, so beutet dies, daß Sie die erste Taste niederhalten 
und dann die zweite Taste drücken, im Beispiel also die SHIFT-Taste nieder¬ 
halten und dann die Pfeil-nach-oben-Taste drücken. 

Um also vorwärts fensterweise durch das Programm zu blättern, drücken Sie 
SHIFT-Pfeil nach unten, um rückwärts zu blättern, SHIFT-Pfeii nach oben. 

Um direkt in die erste Programmzeile zu gelangen, drücken Sie ALT-Pfeil nach 
oben und um direkt zur letzten Programmzeile zu kommen, ALT-Pfeil nach 
unten. 

ALT-Pfeil nach rechts setzt den Cursor an das Ende der aktuellen Programm¬ 
zeile, ALT-Pfeil nach links setzt ihn an den Zeilenanfang. 

SHIFT-Pfeil nach rechts plaziert den Cursor an den Anfang des letzten Viertels 
einer Programmzeile, SHIFT-Pfeil nach links an das Ende des ersten Viertels. 
Dies ist dann hilfreich, wenn sehr lange Programmzeilen bearbeitet werden 
sollen. 

Anhang G enthält eine zeilenweise Beschreibung des Beispielprogramms 
Picture. 


Ein Basic-Programm edieren 

Das Edieren eines Amiga Basic-Programms entspricht der Textbearbeitung 
mit einem Textprogramm. Die Eingabe von Text im List-Fenster erfolgt mit den 
Funktionen Cut (abschneiden), Copy (kopieren) und Paste (ersetzen) aus 
dem Edit-Menü. 

Um neuen Text einzufügen, plazieren Sie zunächst den Cursor an die 
Einfügestelle, indem Sie den Zeiger dorthin bewegen und dann die Auswahlta¬ 
ste drücken. Anschließend geben Sie Ihren Text ein. 
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Mit der BACKSPACE-Taste können Sie Zeichen links vom Cursor löschen. 
Um Zeichen rechts vom Cursor zu löschen, drücken Sie die DEL-Taste. 

Um ein Wort zu wählen, zeigen Sie mit dem Zeiger d’rauf und drücken die 
Auswahltaste der Maus zweimal kurz. 

Zur Auswahl eines ganzen Textblockes drücken Sie am Anfang die Auswahlta¬ 
ste, bewegen dann den Zeiger zum Ende des Blocks und halten hier zuerst die 
SHIFT-Taste nieder und drücken dann die Auswahltaste der Maus erneut. 
Einen so ausgewählten Block können Sie jetzt mit Cut löschen oder mit Copy 
an eine andere Stelle im Programm kopieren. 

Um das List-Fenster zu verbreitern, damit Sie die volle Zeilenlänge sehen 
könen, gehen Sie folgendermaßen vor: 

• Zeigen Sie auf die Titelleiste und halten Sie hier die Auswahltaste der Maus 
gedrückt. Ziehen Sie jetzt das gesamte List-Fenster an den linken 
Bildschirmrand. 

• Geben Sie die Auswahltaste wieder frei und zeigen mit dem Zeiger auf das 
Größen-Symbol in der rechten unteren Fensterecke. Halten Sie hier 
wieder die Auswahltaste gedrückt und ziehen Sie das Fenster so weit 
auseinander, bis Sie die volle Programmzeilenlänge sehen können. 

• Lassen Sie die Auswahltaste wieder los, wenn das Fenster die gewünsch¬ 
te Größe hat. 


Edieren des Beispielprogramms Picture 

Sie haben jetzt die Gelegenheit, am Beispielprogramm Picture erste Edier- 
Erfahrungen zu machen und dabei einiges über die graphischen Anweisungen 
von Amiga Basic zu lernen. Sie brauchen keine Angst zu haben, das 
Programm unbrauchbar zu machen oder zu verlieren. Auf der Diskette 
befindet sich eine Kopie unter dem Namen Picture2. 
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Wenn Sie experimentierfreudig sind, machen Sie ruhig Ihre eigenen Pro¬ 
grammänderungen. Versuchen Sie mit den unten beschriebenen Schritten 
das folgende Programmergebnis zu erzielen: 



Eine Programmzeile hinzufügen Beginnen Sie mit dem Hinzufügen einer 
Programmzeile, die ein zweites Bild erzeugt: 

• Suchen Sie im List-Fenster, bis Sie folgende Programmzeile gefunden 
haben: 
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Jetzt können Sie die neue Zeile eingeben. Beachten Sie, daß Amiga Basic den 
Cursor nach der unmittelbar darüberstehenden Anweisung ausrichtet, um 
Ihnen die Eingabe führender Leerstellen zu ersparen. 


• Geben Sie jetzt ein: 


CIRCLEC200,60>,55,3,,.ASPECT 



'<•.<; 0J-Q2M20) .Be 
PECT - ,1 
HBILE ASPECT<20 

CIRCLEC68,663,55,0,,=ASPECT 
CIRCLEi289,611},55,3,. .ASPECT • 
ASPECT = ASPECT* *!,4 
HEM 

T CS.83-1127,127),P 

IF MOUSE{0)=6 THEN CheciiMouse 
IF ABSCX-HOUSEd)) > 2 THEN NoveFioture 
It AisS(Y-H0iiSE(2>) ( 3 THEN CissckHöuse 
^epicture: 

PüTCX.Y),P 

-N.'USh !;. ¥=H0ÜSEC2J 
PUT£X,V).P 


Geben Sie diese 
Programmzeile 
' ein, um die 
zweite Ellipse 


Diese Anweisung zeichnet eine Ellipse um den Mittelpunkt bei der Position 
200,60 (200 Bildpunkte vom linken Bildschirmrand, 60 Bildpunkte vom oberen 
Bildschirmrand) mit dem Radius von 55 (Bildpunkten) und einem Bildverhält¬ 
nis, das mit der Variablen ASPECT angegeben wird. 3 ergibt die Farbe orange, 
0 die Farbe blau, vorausgesetzt, Sie arbeiten mit den Original-Arbeitstischfar¬ 
ben. Bei jeder Ausführung der WFIILE-Programmschleife wird eine neue 
Ellipse mit anderem Bildverhältnis (ASPECT) gezeichnet. Die einzelnen Ellip¬ 
sen bilden schließich das Abbild des Sphäroiden. 

• Wählen Sie jetzt Start aus dem Run-Menü, um das Programm zu starten. 


Korrektur von Fehlern 

Während der Programm-Edierung kann es durchaus zu Eingabefehlern 
kommen. Findet Amiga Basic während eines Programmlaufes einen Fehler, so 
wird das Programm abgebrochen und die Fehlerbeschreibung wird in einem 
Kommunikationsfenster angezeigt. Amiga Basic stellt dann außerdem sicher, 
daß das List-Fenster sichtbar wird und rollt die Programmliste ab, damit die 
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fehlerhafte Zeile sichtbar wird. Die fehlerverursachende Anweisung wird mit 
einem orangefarbenen Rechteck eingerahmt. Sie können jetzt zur Fehlerbe¬ 
seitigung die Zeile edieren und das Programm neu starten. Dieses Verfahren 
wird “Debugging“ genannt. 


Ersetzen einer Programmzeile 

Trotz der Programmänderung können Sie nur das linke Bild mit der Maus 
bewegen. Nun soll das Programm so gändert werden, daß beide Bilder mit der 
Maus gezogen werden können: 

• Wenn das Programm noch läuft, wählen Sie Stop aus dem Run-Menü, um 
es anzuhalten. 

Wählen Sie jetzt Show List. Die Position des List-Fensters ändert sich jedoch 
nicht. 

• Zeigen Sie auf den äußerst linken Rand der GET-Anweisung, drücken Sie 
die Auswahltaste der Maus und ziehen Sie den Zeiger bis zum Zeilenende, 
dadurch wird die gesamte Zeile in orange hervorgehoben. Sie ist damit 
ausgewählt. 



• Wählen Sie jetzt Cut aus dem Edit-Menü, um die ausgewählte Zeile zu 
löschen. 
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• In der nun leeren Zeile geben Sie folgendes ein: 

GETC0,0)-C3Z7,127),P 

Mit dieser neuen GET-Anweisung vergößern Sie den mit der Maus bewegba¬ 
ren Bildausschnitt. 

Ändern Sie jetzt außerdem die DIM-Anweisung, um ein Feld mit 6000 anstatt 
2500 Elementen zu dimensionieren: 

• Positionieren Sie den Cursor auf die DIM-Anweisung. 

• Wählen Sie den Teil der Anweisung, der auf 2500 lautet, aus, und löschen 
Sie ihn mit Cut aus dem Edit-Menü 

• Geben Sie in den freien Raum zwischen den Klammern 6000 ein, so daß 
die Zeile jetzt lautet: 

DIM PC6000) 



• Wählen Sie Start aus dem Run-Menü, um das Programm zu starten. 

Wenn Sie jetzt auf eines der Bilder zeigen, die Auswahltaste der Maus drücken 
und diese bewegen, bewegen sich beide Bilder mit. 
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Inverse Bilddarstellung 

Jetzt soll das erste Bild in weiß auf blauem Hintergrund dargestellt werden, 
also so: 



• Wenn das Programm noch läuft, halten Sie es mit Stop an und öffnen Sie 
das List-Fenster, 

• Suchen Sie die Programmzeile mit der LINE-Anweisung. 

• Positionieren Sie den Cursor direkt hinter die Zeichen BF an das Ende der 
Zeile, indem Sie dorthin zeigen und die Auswahltaste der Maus drücken. 
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• Drücken Sie die BACKSPACE-Taste einmal, um das Zeichen F zu 
löschen. 

Damit wird das Innere des Rechteckes, innerhalb dem das Bild dargestellt 
wird, in blau und nicht in weiß dargestellt. 

• Suchen Sie die Zeile 

CIFCLE(60,60),SS,0,,,OSPECT 

• Positionieren Sie den Cursor hinter die Ziffer 0. 

• Drücken Sie einmal die BACKSPACE-Taste, um die 0 zu löschen. 

• Geben Sie 1 ein als neuen Farbcode. 



Damit werden die Ellipsen in weiß anstatt in blau gezeichnet. 


• Starten Sie mit Start das Programm neu, um das Ergebnis zu sehen. 


Damit sind alle Programmänderungen vollständig. 


Einzelschritt-Abarbeitung des Programms 

Damit Sie besser mit dem Beispielprogramm Picture vertraut werden, soll jetzt 
eine häufig angewandte Technik zur Fehlersuche beschrieben werden: Die 
Einzelschritt-Abarbeitung eines Programms. 












2-16 


Mit Amiga Basic vertraut werden 


• Wenn das Programm noch läuft, halten Sie es mit Stop an. 

• Wählen Sie das Ausgabefenster, indem sie die Auswahltaste der Maus an 
beliebiger Stelle in diesem Fenster drücken. Amiga Basic quittiert mit der 
Ok-Bereitschaftsanzeige. 

• Geben Sie ein 


end 


und drücken Sie die RETURN-Taste. 

• Wählen Sie Step aus dem Run-Menü. Damit wird die erste Programmzeile 
ausgeführt und dann das Programm angehalten. 

• Wählen Sie Show List aus dem Windows-Menü, um das List-Fenster auf 
der rechten Bildschirmseite zu öffnen und zu aktivieren. 

Jede Anweisung wird nach ihrer Ausführung jetzt im List-Fenster angezeigt. 
Das Ausgabe-Fenster wird gewählt, damit aller eingegebener Text hier 
sichtbar wird. 

• Wählen Sie jetzt Step erneut oder drücken Sie die rechte Amiga-Taste 
zusammen mit der T-Taste. 

Die nächste Zeile wird ausgeführt und angezeigt und das Programm wird 
erneut angehalten. Da bis jetzt keine Ausgabe erfolgt, können Sie auch noch 
nichts sehen. 

Wählen Sie jetzt weiter Step und verfolgen Sie die schrittweise Abarbeitung 
des Programms. Wenn der Teil, bei dem die Ellipse gezeichnet wird, erreicht 
wird, können Sie sehen, wie das Bild erstellt wird. Bei jedem Durchlauf durch 
die WHILE-Schleife wird eine neue Ellipse mit anderem Bildverhältnis gezeich¬ 
net. 
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• Geben Sie, nachdem die ersten Ellipsen gezeichnet sind, folgendes im 
Ausgabe-Fenster ein: 


pr int aspect 


• Drücken Sie die RETURN-Taste. 

Der aktuelle Wert der Variablen für das Bildverhältnis, mit dem die Ellipsen 
gezeichnet werden, wird im Ausgabefenster angezeigt. 

Obwohl ja eigentlich das Beispielprogramm keine Fehler enthält, die mit dieser 
Methode lokalisiert werden könnten, zeigt sie jedoch das Verfahren anschau¬ 
lich. Die Möglichkeit, zu jedem Programmausführungszeitpunkt Basic-Befeh- 
le im Ausgabe-Fenster eingeben zu können, wird als “Befehlseingabe im 
Direktmodus“ bezeichnet. Amiga Basic führt solche Befehle sofort aus und 
zeigt das Ergebnis, falls eines existiert, auch sofort an. Weitere Informationen 
zum Direktmodus finden Sie in Kapitel 3.2. 

• Fahren Sie jetzt mit der schrittweisen Abarbeitung des Beispielpro¬ 
gramms fort. Lassen Sie sich zwischendurch die Inhalte weiterer Variablen 
anzeigen. 

• Wenn Sie die schrittweise Abarbeitung abbrechen wollen und den Rest 
des Programms lieber vollständig ablaufen lassen wollen, wählen Sie 
Continue (fortsetzen) aus dem Run-Menü. 
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Das Programm auf Diskette speichern 

Wenn Sie ein eingegebenes oder geändertes Programm auf Diskette spei¬ 
chern und gleichzeitig die alte Version erhalten wollen, wählen Sie Save As 
(speichern als) aus dem Project-Menü. 

Ist das Programm erst einmal auf Diskette abgelegt, so können Sie es zu 
jedem beliebigen Zeitpunkt wieder laden und ausführen. 

• Wählen Sie Save As aus dem Project-Menü. Es erscheint ein Kommunika¬ 
tionsfenster: 



Amiga Basic nimmt an, daß Sie das Programm unter seinem gegenwärtigen 
Namen (Picture) und in derselben Form (üblicherweise das Binärformat), wie 
Sie es geladen haben, speichern wollen. 

Sie können den Namen ändern, wenn Sie wollen. Der einfachste Weg ist 
jedoch, das OK-Symbolfeld zu wählen. 

Damit haben Sie jetzt zwei Versionen des Programms Picture auf der Diskette. 
Die unveränderte Version unter dem Namen Picture2 und das veränderte 
unter dem Namen Picture. Ebensogut hätten Sie aber auch den Namen in 
Meinprogramm oder jeden anderen gültigen Namen ändern können. Damit 
würde auch das Programm Picture in seiner ursprünglichen Form auf Diskette 
erhalten bleiben. 
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2.2 Beenden von Amiga Basic und Rückkehr zum Arbeitstisch (Workbench) 


• Wählen Sie Quit (aufhören) aus dem Project-Menü. 

Damit haben Sie Ihre erste praktische Arbeit mit Amiga Basic beendet. 

Sie befinden sich jetzt wieder auf dem Arbeitstisch (Workbench) und können mit 
dem Amiga eine andere Arbeit beginnen. Dennoch haben Sie in kurzer Zeit eine 
Menge über die Programmiersprache Amiga Basic gelernt. Sie haben gelernt, 

• ein vorhandenes Programm von Diskette zu laden, 

• ein Programm im List-Fenster zu edieren, 

• mit einigen Basic-Anweisungen und -Funktionen zu arbeiten, 

• ein Amiga Basic-Programm zu speichern. 

Im Kapitel 3 finden Sie die Grundlagen der Arbeit mit Amiga Basic. Hier wird auch 
in einem separaten Abschnitt der Amiga Basic-Bildschirm detailliert beschrieben. 
Sie werden beim Durcharbeiten des Kapitels 3 viele Fakten, die Sie beim 
Bearbeiten des Beispielprogramms gelernt haben, wiederfinden, werden aber 
natürlich auch viel Neues dazulernen. Wie bei allen Amiga-Programmen können 
Sie weder dem Computer noch dem Amiga Basic-Interpreter durch Dateneinga¬ 
be, Mausbedienung oder Fehlerverursachung Schaden zufügen. Deshalb experi¬ 
mentieren Sie ruhig mit Amiga Basic und probieren Sie alle Funktionen und 
Eigenschaften des Bildschirms aus. 


Kurze Zusammenfassung der Programmdatei-Befehle 

Im folgenden werden für alle Aufgaben, die Sie während dieser ersten 
praktischen Arbeit mit Amiga Basic erledigt haben, die Basic-Befehle angege¬ 
ben, die Sie alternativ zum Aufruf von Menü-Punkten mit der Maus im 
Direktmodus verwenden können: 
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Ein existierendes Programm laden 

Zum Laden geben Sie folgenden Befehl ein: 


load "Dateiname” 


Das geladene Programm edieren 

Zum Edieren eines geladenen Programms oder zum Eingeben eines neuen 
Programms geben Sie ein: 


1 ist t Sprunffmai’/ce] 


x ist ruft den Bildschirmeditor von Amiga Basic auf. Wenn Sie eine Sprung¬ 
marke angeben, so wird diese Zeile ganz oben im List-Fenster angezeigt und 
alle ggf. folgenden Zeilen, bis das Fenster gefüllt ist. 


Ein geladenes Programm ausführen 

Zum Starten geben Sie ein: 


run 


Um das Programm anzuhalten, drücken Sie CTRL-C. Um sich z.B. Feldvariab¬ 
leninhalte anzuschauen, können Sie 


for i= 1 to 20 : pr int a( i):next 


eingeben. 

Zum Fortsetzen eines angehaltenen Programms können Sie 


cont 


eingeben. 
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Amiga Basic beenden 

Um die Arbeit mit Amiga Basic zu beenden und zum Arbeitstisch (Workbench) 
zurückzukehren, geben Sie ein: 


System 


Ein Programm auf Diskette speichern 

Wenn das im Hauptspeicher befindliche Programm geändert wurde und Sie 
Amiga Basic verlassen wollen, ohne das Programm zu speichern, erhalten Sie 
die Anzeige 


Current program is not saved 

Do you want to save it befare proceed ing? 


(Aktuelles Programm nicht gespeichert 
Wollen Sie es speichern, ehe Sie fortfahren?) 

Wenn Sie hier das YES-Feld wählen, erhalten Sie in einem Kommunikations¬ 
fenster die Aufforderung zur Eingabe des Dateinamens, worauf das Pro¬ 
gramm gespeichert wird. Ansonsten wird Amiga Basic ohne Speicherung 
beendet. 
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3. Arbeiten mit Amiga Basic 


Dieses Kapitel enthält die grundlegenden Informationen, die Sie für ein erfolgrei¬ 
ches Arbeiten mit dem Amiga Basic-Interpreter benötigen. Es wird beschrieben, 
wie Amiga Basic aufgerufen und beendet wird, wie Programmdateien geladen und 
gespeichert werden und wie die verschiedenen Betriebsmodi von Amiga Basic 
eingesetzt werden können. In einem weiteren Abschnitt wird der Amiga Basic- 
Bildschirm beschrieben. 


3.1 Grundlegende Funktionen 


In diesem Abschnitt wird der Aufruf und das Beenden des Amiga Basic-Interpre- 
ters sowie das Laden und Speichern von Amiga Basic-Programmen beschrieben. 


Aufruf von Amiga Basic 

Sie können den Amiga Basic-Interpreter auf zweierlei Weise aufrufen: 

1. Öffnen Sie das Piktogramm für CLI im Fenster der System-Schublade auf 
dem Arbeitstisch. Das Fenster des AmigaDOS-Befehlsinterpreters wird 
geöffnet und Sie geben über Tastatur 

AmigaBASIC 

ein. Drücken Sie zum Schluß die RETURN-Taste. 

Sie können aber auch gleich den Namen des abzuarbeitenden Basic- 
Programms mit angeben: 

AmigaBASIC MeinFrosi oder! 

run [PfadJfimigaBfiSIC [Pfad]t1ei nprog 

2. Zeigen Sie auf das Amiga Basic-Piktogramm im Fenster der Extras-Dis¬ 
kette und drücken Sie die Auswahltaste der Maus kurz zweimal. Dadurch 
wird zusätzlich das voreingestellte Amiga Basic-Programm geladen und 
gestartet. 



3-2 


Arbeiten mit Amiga Basic 


Beenden von Amiga Basic und Rückkehr zum Arbeitstisch 

Die Arbeit mit Amiga Basic kann auf zweierlei Weise beendet werden: 

1. Wählen Sie Quit aus dem Projekt-Menü. 

2. Geben Sie im gewählten Ausgabe-Fenster ein: 

System 

und drücken Sie die RETURN-Taste oder verwenden Sie den SYSTEM- 
Befehl in einem Amiga Basic-Programm. 


Ein Programm laden 

Um ein Programm ablaufen lassen zu können, muß es im Hauptspeicher sein. 

Es gibt verschiedene Möglichkeiten, ein Amiga Basic-Programm in den 

Hauptspeicher zu laden. 

• Zeigen Sie auf dem Arbeitstisch auf das Piktogramm für das gewünschte 
Amiga Basic-Programm und drücken Sie die Auswahltaste der Maus kurz 
zweimal hintereinander. Damit wird sowohl der Amiga Basic-Interpreter 
als auch das auszuführende Programm geladen und gestartet. 

• Wenn der Amiga Basic-Interpreter bereits aktiviert wurde, wählen Sie 
Open aus dem Project-Menü. Damit werden Sie in einem Kommunikati¬ 
onsfenster aufgefordert, den Namen des zu ladenden Programms einzu¬ 
geben. Wählen Sie hier das Titel-Symbolfeld und geben Sie dann den 
Namen ein. Drücken Sie zum Abschluß entweder die RETURN-Taste oder 
wählen Sie das OK-Symbolfeld. 

• Geben Sie im gewählten Ausgabe-Fenster die Befehle 


1 oad” Da -te iname'’ 


oder 


r-UTo” Da tei name" 


ein, wobei für Dateiname der Name der Programmdatei einzusetzert ist. 



Arbeiten mit Amiga Basic 


3-3 


• Von einem laufenden Amiga Basic-Programm aus kann mit Hilfe der 
CHAIN-Anweisung (s. dort in Kapitel 9) ein weiteres Programm geladen 
und gestartet werden. 


Ein Programm speichern 

Um ein neues Programm zu speichern, können Sie entweder Save As aus dem 
Project-Menü wählen oder den Befehl SAVE im Ausgabe-Fenster eingeben. 
Ein bereits schon einmal früher gespeichertes und jetzt verändertes Pro¬ 
gramm können Sie entweder mit Save aus dem Project-Menü oder durch 
Eingabe des SAVE-Befehls im Ausgabe-Fenster speichern. 

Amiga Basic speichert alle Programme in komprimierter Form, es sei denn, Sie 
geben beim SAVE-Befehl explizit etwas anderes an (s. dort in Kapitel 9). 


3.2 Betriebsarten von Amiga Basic 


Wenn Sie den Amiga Basic-Interpreter aufrufen, wird das Ausgabe-Fenster 
mit dem Titel BASiC geöffnet. Es können jetzt in diesem Fenster Befehle 
eingegeben werden. Dazu stehen drei Betriebsmodi des Interpreters zur 
Verfügung: 

• Direktmodus 

• Ediermodus 

• Programmodus 

Das List-Fenster wird aktiviert, sobald Amiga Basic beginnt zu arbeiten. 


Direktmodus 

Beim Direktmodus werden die Amiga Basic-Befehle oder -Anweisungen 
nicht im Speicher abgelegt, sondern direkt nach der Eingabe im AusgabeFen- 
ster ausgeführt. Ergebnisse arithmetischer oder logischer Operationen wer¬ 
den direkt angezeigt und außerdem zur späteren Verwendung gespeichert. 
Die Anweisung selbst geht jedoch nach ihrer Ausführung verloren. Der 
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Direktmodus ist bei der Fehlersuche und zur Verwendung des Amiga Basic- 
Interpreters als Rechner für schnelle Berechnungen, die kein vollständiges 
Programm erfordern, hilfreich. Um den Direktmodus einzuschalten, müssen 
Sie auf eine beliebige Stelle im Ausgabe-Fenster zeigen und die Auswahltaste 
der Maus drücken. 


Ediermodus 

Im Ediermodus sind Sie, sobald Sie im List-Fenster arbeiten. Die eingegebe¬ 
nen Anweisungen und Befehle werden solange nicht ausgeführt, wie kein 
RUN-Befehl gegeben wird, oder nicht Start aus dem Run-Menü gewählt wird. 


Programmodus 

Sobald ein Programm gestartet ist, befindet sich Amiga Basic im Programmo¬ 
dus. Während der Programmausführung können Sie weder Direktmodus-Be¬ 
fehle eingeben, noch können Sie neue Programmzeilen im List-Fenster 
eingeben. 


3.3 Der Amiga-Basic-Bildschirm 

Der Amiga Basic-Bildschirm gliedert sich in drei Bereiche: 

• das Ausgabe-Fenster 

• das List-Fenster 

• die Menü-Leiste 

Das Ausgabe- und List-Fenster haben einige Eigenschaften gemeinsam: 

• Um ein Fenster zu wählen, wird auf eine beliebige Stelle im Innern gezeigt und 
die Auswahltaste der Maus gedrückt. 

• Um die Fenstergröße zu verändern, kann man das Größen-Symbol in der 
rechten unteren Ecke des Fensterrahmens mit der Maus ziehen. 
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• Um das Hintergrundfenster in den Vordergrund zu holen, wählt man das 
Front-Symbol oben rechts im Fensterrahmen. 

• Um das Vordergrundfenster in den Hintergrund zu bringen, wählt man das 
Hintergrund-Symbol oben rechts im Fensterrahmen. 

• Um ein Fenster zu schließen, wählt man das Schließ-Symbol in der linken 
oberen Ecke des Fensterrahmens. 

• Um das ganze Fenster nach oben oder unten zu ziehen, zeigt man auf die 
Titelleiste, hält die Auswahltaste der Maus gedrückt und zieht die Maus. 

Die Menü-Leiste bietet eine Reihe unterschiedlicher Merkmale: 

• Um die Menü-Leiste anzuzeigen, wählt man das Ausgabe- oder das List- 
Fenster und hält die Menütaste der Maus gedrückt. 

• Zur Anzeige eines individuellen Menüs zeigt man auf den gewünschten 
Menü-Titel bei weiter gedrückter Menütaste. 

• Zur Auswahl aus einem Menü zeigt man mit gedrückter Menütaste auf den 
gewünschten Menü-Punkt, wodurch dieser hervorgehoben wird. Dann läßt 
man die Menütaste los. 


Das Ausgabe-Fenster 

Im Ausgabe-Fenster werden sowohl Anweisungen und Befehle im Direktmo¬ 
dus einegeben als auch Programmausgaben angezeigt. 

Das Ausgabe-Fenster wählen Das Auswahlfenster können Sie auf zweierlei 
Weise wählen: 

• Drücken Sie die Auswahltaste der Maus, wenn der Zeiger an beliebiger 
Position innerhalb des Fensters steht. 


Wählen Sie Show Output (Ausgabefenster zeigen) aus dem Windows- 
Menü und drücken Sie dann die Auswahltaste der Maus innerhalb des 
Fensters. 
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Arbeiten im Ausgabe-Fenster Im Ausgabe-Fenster können Sie: 

• eine Anweisung oder einen Befehl im Direktmodus eingeben und ausfüh¬ 
ren lassen, sobald die RETURN-Taste gedrückt wird. Außerdem wird 
jegliche Programmausgabe hier angezeigt. 

• die BACKSPACE-Taste verwenden, um Eingabefehler zu korrigieren. 

• mit CTRL-C ein Programm anhalten oder eine eingegebene Zeile löschen. 


Das List-Fenster 

Im List-Fenster wird ein Programm eingegeben, ediert und durchgesehen. 
Außerdem kann bei Einzelschrittverarbeitung der Programmablauf hier ver¬ 
folgtwerden. Das List-Fenster wird automatisch gewählt, sobald Amiga Basic 
aufgerufen wird. 

Das List-Fenster wählen Das List-Fenster können Sie auf zweierlei Weise 
wählen: 

• Drücken Sie die Auswahltaste der Maus, wenn der Zeiger an beliebiger 
Position innerhalb des Fensters steht. 

• Wählen Sie Show List (List-Fenster zeigen) aus dem Windows-Menü und 
drücken Sie dann die Auswahltaste der Maus innerhalb des Fensters. 

Wenn das Programm auf Grund eines Fehlers angehalten wird, wird das 
List-Fenster automatisch gewählt und sichtbar gemacht. 

Beachten Sie: Wenn das Programm im geschützten Format gespeichert 
wurde, können Sie dafür das List-Fenster nicht öffnen. Geschützte Program¬ 
me können weder gelistet noch ediert werden. 


Arbeiten im List-Fenster Im List-Fenster können Sie: 

• die Programmliste anschauen und sie mit Hilfe der Cursor-Steuertasten in 
Verbindung mit der SHIFT- oder ALT-Taste abrollen lassen. 

• Eingeben oder Edieren eines Programms unter Zuhilfenahme der kom¬ 
fortablen Edier-Eigenschaften von Amiga Basic. Ausführliches dazu fin¬ 
den Sie in Kapitel 4. 
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3.4 Die Menü-Leiste und Tastaturabkürzungen für das Menü 


Die Menüleiste enthält die Titel für vier Menüs: 

• Project (Programme laden und speichern) 

• Edit (Programme edieren) 

• Run (Programme starten und anhalten) 

• Windows (Fenster anzeigen) 

Sie können zu jedem Zeitpunkt aus jedem dieser Menüs einen beliebigen Punkt 
wählen. Ist jedoch ein Menü-Titel oder in einem Menü einer der Punkte in 
“ Geisterschrift“, also in undeutlich lesbarer Schrift angegeben, so ist dieses Menü 
oder dieser Punkt in der gegenwärtige Arbeitssituation nicht verfügbar, 

Einige Menüpunkte enthalten rechts neben der Bezeichnung eine Tasten-Kombi- 
nation aus einer Buchstabentaste sowie der rechten Amiga-Taste (das ist die 
Taste unmittelbar rechts von der Leertaste auf der Tastatur). Ein Beispiel ist die 
Kombination Amigataste-X-Taste als Ersatz für Cut im Edlt-Menü. Sie müssen in 
diesem Fall die rechte Amigataste niederhalten und dann die X-Taste drücken. 
Alle Tastaturabkürzungen verwenden die rechte Amigataste. 


Das Project-Menü 

Das Project-Menü enthält fünf Punkte die sich auf die Arbeit mit Programmda¬ 
teien beziehen. In diesem Menü gibt es keine Tastaturabkürzungen für die 
einzelnen Punkte. 

New löscht die aktuelle Programmliste im List-Fenster und das Programm im 
Hauptspeicher, so daß Sie mit der Eingabe eines neuen Programms beginnen 
können. New hat dieselbe Wirkung wie der NEW-Befehl (s. dort in Kapitel 9). 

Open veranlaßt Amiga Basic, ein auf Diskette gespeichertes Programm in den 
Hauptspeicher zu laden. Sie können das Ausgabe-Fenster wählen und den 
Befehl FILES eingeben, um sich die Dateien auf der Diskette im aktuellen 
Laufwerk anzuschauen. Open fordert in einem Kommunikationsfenster zur 
Eingabe des Programmnamens auf. Die Eingabe wird durch Wahl des OK- 
Symboles oder durch Drücken der RETURN-Taste abgeschlossen. 
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Save speichert das Programm im Hauptspeicher unter seinem aktuellen 
Namen, nachdem Sie es eingegeben oder geändert haben. Amiga Basic 
speichert alle neuen Programme im komprimierten Format und alle geänder¬ 
ten Programme in dem Format, in dem sie vorher geladen wurden. 

Save As wirkt genauso wie Save mit dem Unterschied, daß Sie hier den 
Namen des zu speichernden Programms vorher ändern können. Auch hier 
werden neue Programme im komprimierten Format und geänderte Program¬ 
me in dem Format gespeichert, in dem sie geladen wurden. 

Um ein Programm im Text-oder im geschützten Format zu speichern, müssen 
Sie den SAVE-Befehl im Direktmodus im Ausgabefenster eingeben. Näheres 
zu den Dateiformaten finden Sie in Kapitel 5 und zu der Syntax des SAVE-Be- 
fehls in Kapitel 9. 

Quit beendet die Arbeit mit Amiga Basic und führt Sie auf den Arbeitstisch 
(Workbench) zurück. Quit wirkt genauso wie der SYSTEM-Befehl. 


Das Edit-Menü 

Das Edit-Menü enthält drei Punkte für die Eingabe und Edierung von 
Programmen. Mit Ausnahme der Eingabe von Anweisungen und Befehlen im 
Direktmodus im Ausgabe-Fenster erfolgt die Eingabe und Edierung von 
Programmzeilen ausschließlich im List-Fenster. Für jeden der drei Punkte 
existiert eine Tastatur-Abkürzung. 

Cut löscht den aktuell ausgewählten Bereich aus dem List-Fenster und legt 
ihn in einem Zwischenspeicher ab. Drücken der Tasten Amiga-X bewirkt 
dasselbe. 

Copy legt den aktuell ausgewählten Bereich im Zwischenspeicher ab, ohne 
ihn im List-Fenster zu löschen. Drücken der Tasten Amiga-C hat dieselbe 
Funktion. 

Paste ersetzt den aktuell ausgewählten Bereich durch den Inhalt des Zwi¬ 
schenspeichers. Wenn kein Bereich ausgewählt war, wird der Zwischenspei¬ 
cherinhalt rechts von der Cursor-Position eingefügt. Drücken der Tasten 
Amiga-P hat dieselbe Wirkung. 
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Das Run-Menü 

Im Run-Menü sind sechs Punkte enthalten, die die Programmausführung 
steuern. Für vier von ihnen existieren Tastatur-Abkürzungen: 

Start startet das aktuell im Hauptspeicher befindliche Programm. Die Eingabe 
des RUN-Befehls im Ausgabe-Fenster oder Drücken von Amiga-R haben 
dieselbe Wirkung. Im Direkt-Modus kann ein Amiga Basic-Programm, so im 
Speicher vorhanden, jederzeit gestartet werden. 

Stop unterbricht ein ablaufendes Programm. Stop hat dieselbe Wirkung wie 
die STOP-Anweisung in einem Programm. Die Tastenkombinationen Amiga-, 
(Punkt) oder CTRL-C sind die Tastaturabkürzungen für Stop. 

Continue setzt ein unterbrochenes oder angehaltenes Programm fort. Die 
Eingabe des CONT-Befehls im Ausgabe-Fenster hat dieselbe Wirkung. 
Continue ist nur aktivierbar, wenn ein Programm vorher angehalten oder 
unterbrochen wurde und die Fortsetzung möglich ist. Wurde kein Programm 
angehalten oder unterbrochen, oder wurde das Programm während der 
Unterbrechung verändert, wird in einem Kommunikationsfenster die Meldung 
Can’t continue (Fortsetzung nicht möglich) angezeigt. 

Suspend hält ein laufendes Programm solange an, bis eine andere Taste als 
Amiga-S gedrückt wird. Drücken von Amiga-S oder CTRL-S hat dieselbe 
Wirkung wie die Wahl von Suspend. Sobald ein Programm läuft, ist Suspend 
wählbar. 

Trace On/Off ist ein Schalter, mit dem die Programmablaufverfolgung zum 
Zweck der Fehlersuche ein- und ausgeschaltet werden kann. Wenn das 
List-Fenster sichtbar ist, wird hier jede ausgeführte Anweisung hervorgeho¬ 
ben dargestellt. Wird Trace On gewählt, so hat dies dieselbe Wirkung wie der 
TRON-Befehl, bei dem die letzte ausgeführte Anweisung mit einem Rechteck 
eingerahmt wird. Wird keine Anweisung ausgeführt, so wird auch kein 
Rechteck angezeigt. Damit kann bestimmt werden, wo das Programm ange¬ 
halten wurde. Trace Off hat dieselbe Wirkung wie der TROFF-Befehl. Die 
Hervorhebung der schrittweise abgearbeiteten Anweisungen wird ausge¬ 
schaltet. 

Step schaltet die schrittweise Programmabarbeitung ein. Nach jeder ausge¬ 
führten Anweisung hält das Programm an. Dieselbe Wirkung hat Drücken von 
Amiga-T. Bei sichtbarem List-Fenster wird die gerade ausgeführte Anwei¬ 
sung mit einem Rechteck umrahmt. 
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Das Windows-Menü 

Das Windows-Menü stellt zwei Punkte für das Öffnen von Fenstern auf dem 
Amiga Basic-Bildschirm zur Verfügung: 

Show List öffnet und wählt das List-Fenster für das aktuelle Programm. Wenn 
das List-Fenster bereits geöffnet ist, aber vom Ausgabe-Fenster überdeckt 
wird, wird es mit Show List überdas Ausgabefenster gelegt. Dieselbe Wirkung 
hat Drücken von Amiga-L. Zur Edierung eines geladenen oder zur Eingabe 
eines neuen Programms kann auch der LIST-Befehl im Direktmodus im 
Ausgabe-Fenster eingegeben werden. 

Show Output öffnet das Ausgabe-Fenster und legt ggf. das List-Fenster in 
den Hintergrund. Um Direktmodus-Befehle oder -Anweisungen im Ausga¬ 
be-Fenster eingeben zu können, muß es erst gewählt werden. 
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4. Edieren und Testen von 
Amiga-Basic-Programmen 


ln diesem Kapitel lernen Sie die Erfassung von Amiga Basic-Programmen, ihre 
Bearbeitung sowie das Testen und die Fehlerbeseitigung. 


4.1 Programm-Edierung 


Sobald Sie Amiga Basic aufgerufen haben, wird das List-Fenster aktiviert. Zur 
Eingabe und Bearbeitung der Programmzeilen dienen die schon erwähnten 
Edier—Hilfen Cut, Copy und Paste aus dem Edit-Menü. Anfangs erscheint das 
List-Fenster etwas schmal für längere Programmzeilen. Wenn Sie bei der Textein¬ 
gabe den rechten Rand erreichen, wird der Fensterinhalt nach links gerollt, so daß 
der Cursor immer im sichtbaren Bereich des Fensters bleibt. Zum linken Rand 
gelangen Sie wieder, indem Sie ALT-Pfeil nach links drücken. Sie können aber 
auch durch Ziehen des Fensters nach links und anschließendem Ziehen des 
Größen-Symbols in der rechten unteren Ecke des Fensterrahmens das List-Fen¬ 
ster über den ganzen Bildschirm legen. 

Die Edierung von Programmzeilen im List-Fenster funktioniert prinzipiell wie die 
Textbearbeitung in einem Text-Programm. Im folgenden werden nocheinmal alle 
Funktionen des Bildschirmeditors von Amiga Basic zusammengestellt: 


Eingeben und Edieren von Text 

• Text wird eingefügt, indem er über die Tastatur eingegeben wird oder mit 
Paste aus dem Zwischenspeicher kopiert wird. Text wird immer rechts 
von der Cursor-Position eingefügt. 

• Text wird mit der BACKSPACE-Taste gelöscht oder ausgewählt und dann 
mit Cut aus dem Edit-Menü gelöscht. 

• Jede Programmzeile wird durch Drücken der RETURN-Taste abgeschlos¬ 
sen. Es sind auch einzelne Leerzeilen in Amiga Basic-Programmen 
erlaubt. Diese werden bei der Programmausführung ignoriert. 




4-2 


Edieren und Testen von Programmen 


• Textzeilen können mit Hilfe der TAB-Taste eingerückt werden. Drücken 
der TAB-Taste setzt den Cursor um drei Schreibpositionen nach rechts. 
Wird am Zeilenende die RETURN-Taste gedrückt, so wird der Cursor in 
der nächsten Zeile direkt unterhalb dem ersten Zeichen in der vorange¬ 
gangenen Zeile positioniert. Beginnt die vorangegangene Zeile mit einem 
Tabulator, so beginnt die Folgezeile automatisch ebenfalls mit einem 
Tabulator. Dieses Einrücken von Text kostet keinen zusätzlichen Spei¬ 
cherplatz. 

• Reservierte Wörter, also die Schlüsselwörter der Amiga Basic-Sprache, 
können in Klein-, Groß- oder gemischter Schreibweise eingegeben 
werden. Amiga Basic wandelt sie generell in Großschrift und zeigt sie auch 
so an. 

• Variablennamen dürfen bis zu 40 Zeichen lang sein. Numerische Variablen 
werden voreinstellungsgemäß immer als einfachgenaue Variablen ange¬ 
nommen, es sei denn, Sie geben durch ein spezielles Zeichen etwas 
anderes an oder verwenden DEFINT-, DEFLNG-, DEFSNG-, DEFDBL- 
oder DEFSTR-Anweisungen. Die speziellen Typ-Zeichen sind $ für Zei¬ 
chenkette, ! für einfache Genauigkeit, # für doppelte Genauigkeit, % für 
kurze und & für lange Ganzzahl. Variablennamen können in Klein-, Groß¬ 
oder gemischter Schreibweise eingegeben werden. Intern werden sie 
generell in Großschreibweise gewandelt. 

Alpha, ALPHA, AlpHa und alpha sind also dasselbe. 

• Programmzeilen können Nummern vorangestellt werden. Sie sind jedoch 
nicht erforderlich und die Zeilen mit Nummern werden nicht nach aufstei¬ 
genden Nummern geordnet. 


Text auswählen 

• Zeichen, Wörter oder ganze Zeilen können ausgewählt werden, indem die 
Hervorhebung mit der Maus gezogen wird. 

• Die schnellste Methode, eine ganze Zeile auszuwählen, ist, auf den 
Zeilenanfang zu zeigen und die Hervorhebung eine Zeile nach unten zu 
ziehen. 

• Wird die Hervorhebung über den rechten Rand des List-Fensters hinaus¬ 
gezogen, so wird der Fensterinhalt kontinuierlich mit dem Ziehen nach 
links gerollt. 
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• Einzelne Wörter in verschiedenen Zeilen können durch Zeigen und 
zweimaliges kurzes Drücken der Auswahltaste der Maus ausgewählt 
werden. 

Eine weitere Möglichkeit, einen größeren Textblock auszuwählen besteht 
darin, am Blockanfang die Auswahltaste der Maus einmal kurz zu drücken, 
dann auf das Ende des Textes zu zeigen, und diesmal bei gedrückter 
SHIFT-Taste die Auswahltaste der Maus nocheinmal zu drücken. 


Text im List-Fenster rollen 

• Wenn Sie bei der Texteingabe das untere Ende des List-Fenster erreicht 
haben und weiter eingeben, wird der Text im Fenster zeilenweise nach 
oben gerollt. 

• Wenn Sie bei der Texteingabe den rechten Rand des List-Fensters 
erreichen und weiter eingeben, wird der Fensterinhalt kontinuierlich nach 
links gerollt. 

• Der Text-Cursor, der gleichzeitig die Position markiert, bei der Text ein- 
oder angefügt wird, kann mit den Cursor-Steuertasten (den vier Pfeilta¬ 
sten) nach rechts, links, oben oder unten bewegt werden. 

• Wenn Sie die Pfeil-nach-rechts-Taste drücken und der Cursor am 
rechten Rand des List-Fensters steht, wird der Fensterinhalt um ca. 75% 
der Fensterbreite nach links gerollt. Das äußerst rechte Ende der mögli¬ 
chen Anzeige wird durch einen Piepton angezeigt. Entsprechendes gilt für 
die anderen drei Pfeiltasten. 

• Wenn Sie bei niedergehaltener SHIFT-Taste eine der Pfeiltasten drücken, 
wird die Anzeige in die entsprechende Richtung gerollt. Am Ende der 
jeweiligen Richtung wird ein Piepton erzeugt. 

• Zum fensterweisen Durchsehen eines Programms zum Programmende 
hin dient die Tastenkombination SHIFT—Pfeil nach unten, zum Programm¬ 
anfang hin SHIFT-Pfeil nach oben. 

• Um zum Anfang einer Programmliste zu gelangen, dient die Tastenkombi¬ 
nation ALT-Pfeil nach oben, zum Programmende ALT-Pfeil nach unten. 
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• Um zum Ende der aktuellen Programmzeile zu gelangen, dient die 
Tastenkombination ALT-Pfeil nach rechts, zum Zeilenanfang ALT-Pfeil 
nach links. 

• Um ca. 75% der Länge der aktuellen Programmzeile zum Zeilenende hin zu 
überspringen, dient die Tastenkombination SHIFT—Pfeil nach rechts, zum 
Zeilenanfang hin SHIFT-Pfeil nach links. 


List-Fenster bei einer bestimmten Zeile oder Marke öffnen 

Um das List-Fenster und damit die Programmanzeige bei einer bestimmten 
Zeile zu öffnen, geben Sie im Ausgabe-Fenster den Befehl LIST und die 
entsprechende Zeilennummer oder Sprungmarke ein. Das List-Fenster wird 
dann geöffnet und zeigt als erste Zeile die angegebene Zeile an. 

Bei dem in Kapitel 2 behandelten Beispielprogramm Picture wird z.B. durch 
die Eingabe 


LIST lioveP icture 


das List-Fenster geöffnet und die Programmliste beginnend mit dem Move- 
Picture-Unterprogramm gezeigt. 


4.2 Testen von Amiga Basic-Programmen 


Im folgenden werden die vier Hilfsmittel beschrieben, die Amiga Basic für das 
Testen und die Fehlerbeseitigung bei Basic-Programmen zur Verfügung stellt. 
Damit wird die Fehlersuche und -beseitigung wesentlich erleichtert. 


Fehlermeldungen 

Wenn Amiga Basic bei der Programmabarbeitung einen Fehler findet, wird das 
Programm angehalten und ein Kommunikationsfenster wird geöffnet, in dem 
eine Fehlermeldung angezeigt wird. Die fehlerhafte Zeile selbst wird im 
List-Fenster angezeigt, wenn dieses sichtbar ist. Im Anhang B sind alle 
Fehlermeldungen zusammen mit den Fehlercodes tabellarisch zuammenge- 
faßt. Dort werden auch Hinweise der möglichen Fehlerursache und -Beseiti¬ 
gung gegeben. 
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Der TRON-Befehl 

Der TRON-Befehl hat seinen Namen von TRace ON (Programmablaufverfol¬ 
gung ein). Dieser Modus wird durch Wählen von Trace aus dem Run-Menü, 
durch einen TRACE-Befehl in einem Programm oder durch Eingeben von 
TRACE im Ausgabe-Fenster eingeschaltet. 

Wenn das List-Fenster sichtbar ist, wird jede Anweisung, die gerade ausge¬ 
führt wird, mit einem orangefarbenen Rechteck umrahmt. 

Um die Programmablaufverfolgung wieder auszuschalten, wählen Sie Trace 
aus dem Run-Menü erneut, führen einen TRACE OFF-Befehl in einem 
Programm aus oder geben im Ausgabe-Fenster TRACE OFF ein. 

Wenn Sie einen Programmfehler auf einen kleinen Programmbereich einge¬ 
grenzt haben, ist es leichter und schneller, den TRON-Modus vom Programm 
aus einzuschalten, kurz ehe der Fehler auftritt. 


Schrittweises Abarbeiten von Programmen 

Mit Hilfe von Step aus dem Run-Menü oder durch Drücken von Amiga-T kann 
ein Programm schrittweise abgearbeitet werden. Wenn ein Programm unter¬ 
brochen wurde, wird mit Step die nächste Anweisung im Programm ausge¬ 
führt und das Programm wird dann erneut unterbrochen. Bei mehreren 
Anweisungen in der Zeile wird jede Anweisung einzeln ausgeführt. 

Ist das List-Fenster sichtbar, wird die zuletzt ausgeführte Anweisung um¬ 
rahmt. 

Sie können sich so schrittweise durch ein Programm hindurcharbeiten und zu 
jeder Zeit die Inhalte von Programmvariablen anschauen, indem Sie die 
PRINT-Anweisung im Ausgabe-Fenster verwenden. 

Wenn Sie die END-Anweisung im Ausgabe-Fenster eingeben, wird Step 
ausgeschaltet und das Programm kann von Anfang an neu gestartet werden. 

Bei aktivierter Unterbrechungsreaktionsfähigkeit (BREAK ON-Anweisung, s. 
dort in Kapitel 9) kann Step nicht verwendet werden. 
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Pausen beim Programmabiauf 

Ein ablaufendes Programm kann mit Suspend aus dem Run-Menü oder durch 
Drücken von Amiga-S angehalten werden, bis eine beliebige andere Taste 
außer Amiga-S gedrückt oder Continue aus dem Run-Menü gewählt wird. 
Suspend ist immer dann aufrufbar, wenn ein Programm abläuft. 


Fortsetzen unterbrochener Programme 

Unterbrochene oder angehaltene Programme können entweder durch Einga¬ 
be des CONT-Befehls im Ausgabe-Fenster oder mit Continue aus dem 
Run-Menü fortgesetzt werden. 


Verwendung der Edier-Hilfen Cut, Copy und Paste im List-Fenster 

Vergessen Sie nicht, daß der Inhalt des Editor-Zwischenspeichers bei jedem 
Aufruf der Edier-Hilfen Cut oder Copy überschrieben wird. Paste dagegen 
verändert den Zwischenpufferinhalt nicht, da diese Edier-Hilfe nur lesend 
zugreift. Deshalb kann mit Paste der Zwischenpufferinhalt so oft in verschie¬ 
dene Programmteile eingefügt werden, wie notwendig. 

Es kann Vorkommen, daß man einen Programmteil löschen möchte, ohne den 
Zwischenspeicher zu überschreiben. Dies kann folgendermaßen erreicht 
werden: Sie wählen zunächst den zu löschenden Teil aus, der dadurch im 
List-Fenster hervorgehoben erscheint. Anschließend löschen Sie ihn durch 
wiederholtes Drücken der BACKSPACE-Taste. Auf diese Weise verhindern 
Sie auch die Fehlermeldung Out of Heap Space (Arbeitsspeicher-Überlauf), 
die dann wahrscheinlich wird, wenn sehr große Textblöcke mit Cut gelöscht 
werden. 


4.3 Programmtest mit dem Ausgabe-Fenster 


Wenn ein Programm angehalten oder unterbrochen wurde, kann man sich mit 
Hilfe des Ausgabe-Fensters und des Direktmodus nützliche Informationen 
über den augenblicklichen Programmzustand anzeigen lassen. Wenn das 
Programm z.B. mit einer Fehlermeldung abgebrochen wurde, als es gerade 
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eine Schleife abgearbeitet hat, kann man sich die Anzahl der bereits ausge¬ 
führten Schleifendurchläufe zusammen mit den Werten aller Variablen anzei- 
gen lassen. Dazu wird die PRINT-Anweisung (s. dort in Kapitel 9) im 
Direktmodus im Ausgabe-Fenster eingegeben. 

Eine andere Verwendungsmöglichkeit des Ausgabe-Fensters beim Pro¬ 
grammtest besteht im Verändern von Variablenwerten mit Hilfe der LET-An- 
weisung (s. dort in Kapitel 9) im Direktmodus. Sie können einer Variablen des 
unterbrochenen Programms einen neuen Wert zuweisen, und mit Continue 
aus dem Run-Menü die Verarbeitung fortsetzen. 
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5. Arbeiten mit Dateien und Geräten 


ln diesem Kapitel wird beschrieben, wie mit Amiga Basic Ein-/Ausgabeinformatio- 
nen verarbeitet werden und wie der Interpreter Dateien und Geräte behandelt. 
Weiterhin wird die Dateiverwaltung mit Amiga Basic behandelt und es werden 
Möglichkeiten des Datentransfers zwischen Amiga Basic und Textverarbeitungs¬ 
programmen diskutiert. 


5.1 Allgemeine Geräte-Ein-/Ausgabe 


Amiga Basic unterstützt verallgemeinerte Ein-/Ausgabe. Das hat den Vorteil, daß 
verschiedene Ein-/Ausgabegeräte mit derselben Syntax programmiert werden 
können, die Amiga Basic für den Zugriff auf Disk-Dateien (Floppy-Disk oder 
Festplatte) verwendet. Dabei kennt Amiga Basic folgende Geräte mit den Namen: 

SCRN: Ausgabedateien können unter diesem Namen geöffnet werden, 

wenn Daten an den Bildschirm ausgegeben werden sollen. 

KYBD: Eingabedateien können unter diesem Namen geöffnet werden, 

wenn die Daten von der Tastatur gelesen werden sollen. 

LPT1: Ausgabedateien können unter diesem Namen geöffnet werden, 

wenn Daten an den Drucker ausgegeben werden sollen. Wird 
LPT1 :BIN als Namen verwendet, so werden die Daten im Binärfor¬ 
mat ausgegeben. In diesem Fall werden die Daten von Amiga Basic 
nicht interpretiert, also keine Leerstellen bei Tabulatorcodes und 
keine Wagenrücklaufcodes beim Überschreiten der eingestellten 
Zeilenlänge ausgegeben. 

COM1: Ein-/Ausgabedateien können unter diesem Namen geöffnet wer¬ 

den, wenn Daten über die serielle Schnittstelle (RS232-Port) ein- 
oder ausgegeben werden sollen. Amiga Basic erkennt die folgen¬ 
den Parameter als Bestandteil des COM1:-Dateinamens: 


COM1 :[Baud\[,[Parität\[,[ Wort!\[,[Stopb\^ 
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Baud Die Übertragungsgeschwindigkeit in Bits/Sekunde als Zah¬ 
lenwert. Die hiermit gesetzte Baud-Rate hat Priorität vor der mit 
dem Voreinsteller Preferences gewählten. Folgende Baud-Raten 
sind möglich: 110,150, 300,600,1200,1800,2400,3600,4800,7200, 
9600, 19200. 

Parität Ein Buchstabe, der die Art der Paritätsprüfung der übertra¬ 
genen Daten angibt. Möglich sind hier E für gerade Parität (Even), O 
für ungerade Parität (Odd) oder N für keine Paritätsprüfung (None). 

Wort! Eine Ziffer, die angibt, aus wievielen gültigen Datenbits ein 
Datenwort besteht. Erlaubt sind hier 5, 6, 7 oder 8. 

Stopb Eine Ziffer, die angibt, wieviele Bits das Ende eines Daten¬ 
wortes markieren. Bei 110 Baud sind es standardmäßig 2, bei allen 
anderen Baudraten standardmäßig 1. Bei 5 Datenbits und angege¬ 
benen 2 Stopbits werden intern 1.5 Stopbits verwendet. 

Beispiel: 

OPEM "COM1: 300, N, V, 2" ftS #1 

S. a. OPEN “COM1 :-Anweisung in Kapitel 9. 


Drucker-Unterstützung 

Der Amiga unterstützt eine ganze Reihe von Druckern, die beim Voreinsteller 
Preferences angegeben sind. Soll die von Ihnen erzeugte Druckerausgabe 
Funktionen wie Randsetzen, Kursivschrift und ähnliches benutzen, müssen 
Sie dazu spezielle Druckercodes ausgeben. 

Für diesen Zweck enthält der Amiga ein spezielles Druckertreiber-Programm 
für jeden unterstützten Drucker. Jedes dieser Programme wandelt die Stan¬ 
dard-Druckersteuerzeichen in die speziellen Zeichenfolgen für den jeweiligen 
Drucker. 
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AmigaDOS unterscheidet drei Drucker-Einheiten: 

• PRT: 

• SER: 

• PAR: 

Bei SER: und PAR: werden die Daten über die serielle bzw. parallele 
Schnittstelle ausgegeben. Hier werden jedoch die Standard-Drucksteuerzei¬ 
chen nicht umgesetzt, so daß diese beiden Einheiten für die normale Anwen¬ 
dung ziemlich ungeeignet sind. Bei seriellen Übertragungen (z.B. Terminal-E¬ 
mulatoren oder Datentransfer zu anderen Computern ist die COM1:—Einheit 
besser geeignet als SER:, weil mit ihr direkt die Übertragungsparameter wie 
Baud-Rate, Parität und Wortlänge gesetzt werden können. 

Die PRT:-Einheit arbeitet bevorzugt mit dem bereits weiter oben erwähnten 
Gerät LPT1:. LPT1: ist ein von Microsoft vergebener Gerätename, um die 
Software-Übertragbarkeit zwischen unterschiedlichen Rechnern zu gewähr¬ 
leisten. 

Wenn Sie Ihre Programmausgabe speziell formatieren wollen, können Sie die 
entsprechenden Drucker-Steuercodes in PRINT#-Anweisungen im Pro¬ 
gramm angegeben. Diese sogenannten “Escape-Sequenzen“ bestehen aus 
dem ESC-Zeichen (ASCII-Code 27), gefolgt von einem oder mehreren 
anderen Zeichen. 

Wenn Sie z.B. den Commodore-Drucker MPS-1000 an Ihrem Amiga ange¬ 
schlossen haben und bestimmte Stellen in Ihrem Dokument durch UnterstreL 
chung hervorheben wollen, gehen Sie folgendermaßen vor: 

Wählen Sie zunächst diesen Druckertyp mit dem Voreinsteller Preferences (s. 
Amiga-Benutzerhandbuch). Dann geben Sie die Escape-Sequenzen zum 
Ein- und Ausschalten der Unterstreichungs-Funktion in PR INT#-Anweisun¬ 
gen an, wie es das folgende Beispiel demonstriert: 

UnterEIN$=CHR$(27) + ”C4m" 

UnterAUS$=CHR$( 27 )*" C 24m" 

Text1$ "Niirm,( 1er Text" 

Text2$="Ur»terstr i ebener Text" 

OFEN "LPT1: " FOR OUTPUT fiS #2 
PRI NT!t2 j Text 1$ 

PRIMT#2,UnterEIN$*Text2$ 

PRINTH2,UnterfiUS$*Text1$ 


CLOSE #2 
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5.2 Dateibenennungs-Konventionen 


Amiga Basic hat einige Vorschriften hinsichtlich der Angabe von Dateinamen. 
Jede Datei wird durch ihren Namen mit optional vorangesteliter Disk-Kennung 
und/oder einem oder mehreren geschachtelten Unterverzeichnis-Namen be¬ 
schrieben. Eine komplette Dateibezeichnung wird als Pfadname bezeichnet. 


Dateinamen 

Amiga Basic unterstützt die hierarchische Dateiorganisation des AmigaDOS, 
bei der Unterverzeichnisse erlaubt sind, vollständig. Es kennt also auch 
Pfadnamen (s. dazu AmigaDOS-Benutzerhandbuch, Kapitel 1.3). 


Ein kompletter Pfadname (das ist die Angabe, mit deren Hilfe Amiga Basic eine 
bestimmte Datei im hierarchisch gegliederten Dateisystem des AmigaDOS 
findet) darf zwischen 1 und 255 Zeichen lang sein und kann sowohl aus Groß- 
und Kleinbuchstaben als auch aus einem Gemisch aus beiden bestehen. 
Jeder Datei- oder Unterverzeichnisname innerhalb eines Pfadnamens darf bis 
zu 30 Zeichen lang sein, darf jedoch keine Steuerzeichen enthalten. Gültige 
Dateinamen sind z.B.: 

KUNDEN (12400 MeineDatei TEST DATEN 

Um ein bestimmtes Laufwerk oder eine Diskkennung als Bestandteil eines 
Pfadnamens anzugeben, wird dessen/deren Namen, gefolgt von einem Dop¬ 
pelpunkt, vor dem Dateinamen angegeben, also z.B.: 

Demos:BiIder 
DFl:KontenftRCHIU 

Ein Unterverzeichnis-Name (wie z.B. eine Schublade auf dem Arbeitstisch) 
wird mit einem Schrägstrich (/) vom eigentlichen Dateinamen getrennt, also 

z.B.: 


BasicDemos/Picture 

Briefe: Mot. i zen/arbe itsdatei 

DFl • Ber ichte/flärz 


in den beiden letzten Beispielen wird gezeigt, wie eine Diskkennung vor dem 
Unterverzeichnisnamen angegeben wird. Weitere Informationen zu Dateina¬ 
men finden Sie im AmigaDOS-Benutzerhandbuch, Kapitel 1.3. 
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Disk-Kennung 

Ihr Amiga ist mit einem eingebauten Floppy-Disk-Laufwerk ausgerüstet. Zum 
Ausbau der externen Speicherkapazität lassen sich weitere Laufwerke an¬ 
schließen. Aber gerade bei nur einem Laufwerk werden Sie sicher häufig mit 
mehreren Datendisketten arbeiten. In diesem Fall müssen Sie bei einer 
Dateieröffnung angeben, auf welche Diskette zugegriffen werden soll. Zu 
diesem Zweck wird bei der Formatierung einer Diskette ein Name, die 
Disk-Kennung, vergeben. Diese Kennung stellen Sie bei der Eröffnung einer 
Datei mit einem Doppelpunkt an den Anfang des Fhädnamens. 

Das Laden von Programmdateien geht am einfachsten mit Open aus dem 
Project-Menü. Befindet sich das zu ladende Programm auf einer anderen 
Diskette, nehmen Sie die Diskette aus dem eingebauten Laufwerk und legen 
Sie die entsprechende Diskette hier ein. Danach können Sie sich mit dem 
FILES-Befehl (s. dort in Kapitel 9) den Disketteninhalt ansehen und dann die 
gewünschte Programmdatei in der üblichen Weise laden. Wenn Sie eine Datei 
auf einer anderen als der eingelegten Diskette speichern wollen, wählen Sie 
am besten Save As aus dem Project-Menü und verfahren dann genau wie 
beim Laden. 

Das Laden von anderen Disketten kann ebenso mit den LOAD-, MERGE- 
oder RUN-Befehlen (s. dort in Kapitel 9) geschehen, indem Sie bei der 
Eingabe im Direktmodus im Ausgabefenster vor den Dateinamen die Disk- 
Kennung zusammen mit einem Doppelpunkt angeben. Wenn jedoch nicht 
vorher schon die richtige Diskette eingelegt wurde, wird die Fehlermeldung 
Unknown Volume (unbekannte Diskette) angezeigt. 


5.3 Das Arbeiten mit Dateien 


In diesem Abschnitt werden die grundlegenden Ein-/Ausgabe-Mechanismen für 
den Amiga Basic-Anfänger beschrieben. Aber auch der mit einem dateibezoge¬ 
nen Fehler Konfrontierte kann hier nachschlagen, um sich über die korrekte 
Anwendung der Dateibearbeitungsanweisungen zu informieren. 
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Befehle und Anweisungen für Programmdateien 

Im folgenden erhalten Sie einen kurzen Überblick über die Befehle und 
Anweisungen, mit denen Sie Programmdateien verwalten können. Detaillierte 
Hinweise und Syntaxbeschreibungen finden Sie bei den jeweiligen Befehlen 
oder Anweisungen in Kapitel 9. 


Eröffnen einer Programmdatei 

Eine Programmdatei können Sie auf drei verschiedene Weisen öffnen. Die 
üblichste ist der LOAD-Befehl. Wenn Sie eine Programmdatei laden, werden 
alle ggf. zu diesem Zeitpunkt geöffneten Dateien geschlossen, der Hauptspei¬ 
cherwird gelöscht und das Programm wird in den Hauptspeicher geladen. 

Eine andere Möglichkeit zum Laden einer Programmdatei besteht im Anfügen 
der geladenen Datei an ein bereits im Hauptspeicher befindliches Programm. 
Dies geschieht mit Hilfe des MERGE-Befehls (s. dort in Kapitel 9) und ist 
immer dann zu empfehlen, wenn ein sehr großes Programm erstellt wird, das 
in einzelnen Segmenten getestet wird. Im Anschluß an das Testen können 
dann die einzelnen Segmente zusammengemischt werden. 

Eine dritte Möglichkeit besteht in der Übergabe der Steuerung an ein anderes 
Prografhm innerhalb eines Programmes mit Hilfe der CHAIN-Anweisung (s. 
dort in Kapitel 9). Wird diese Anweisung verwendet, so lädt ein im Hauptspei¬ 
cher befindliches Programm ein anderes Programm. Das aufrufende Pro¬ 
gramm wird dann überlagert. Wahlweise Parameter erlauben die Übergabe 
bestimmter oder aller Variablen oder auch das Einmischen des geladenen in 
das aufrufende Programm. 


Speichern In Programmdateien 

Üblicherweise wird eine Programmdatei mit Hilfe von Save oder Save As aus 
dem Project-Menü (s. Kapitel 3.4) oder durch Eingeben des SAVE-Befehls (s. 
dort in Kapitel 9) auf Diskette gespeichert. Voreinstellungsmäßig werden 
Programmdateien im Binärformat gespeichert. 

Wenn Sie die Programmdatei im geschützten Format speichern wollen, um 
Listen oder Änderungen zu verhindern, können Sie den Parameter P beim 
SAVE-Befehl verwenden. Zusätzlich sollten Sie aber immer eine ungeschütz¬ 
te Version speichern, um Änderungen ausführen zu können. 
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Mit dem Parameter A können Sie mit dem SAVE-Befehl ein Programm im 
ASCII-Format speichern, also in dem Format, in dem es im List-Fenster 
angezeigt oder auf dem Drucker ausgedruckt wird. Eine ASCII-Datei benötigt 
zwar mehr Platz auf der Diskette, kann andererseits aber von Textprogram¬ 
men gelesen werden. Außerdem verlangen die Befehle CHAIN MERGE und 
MERGE dieses Format. 


Weitere Datei-Befehle 

Der NAME-Befehl erlaubt die Umbenennung beliebiger Programm- oder 
Datendateien auf Diskette. Mit dem KILL-Befehl können Sie Programm- oder 
Datendateien von Diskette löschen. Nähere Informationen zu diesen beiden 
Befehlen finden Sie in Kapitel 9. 


5.4 Datendateien für sequentiellen und direkten Zugriff 

Amiga Basic erlaubt die Erzeugung und Bearbeitung von zwei verschiedenen 
Typen von Daten-Dateien: 

• Sequentielle Dateien 

• Direktzugriffs-Dateien. 


Sequentielle Dateien 


Sequentielle Dateien sind zwar einfacher zu erzeugen als Direkzugriffs-Da- 
teien, sind jedoch nicht so flexibel und erlauben auch nicht einen so schnellen 
Datenzugriff wie letztere. In einer sequentiellen Datei werden die Datenele¬ 
mente als Gruppen von ASCII-Zeichen eines nach dem anderen (sequentiell) 
in der Datei abgelegt. In derselben Ordnung werden sie dann auch wieder aus 
der Datei gelesen. 

Achtung: Eine sequentielle Datei kann entweder nur zum Schreiben oder nur 
zum Lesen geöffnet werden. Nicht für beide Zugriffsarten gleichzeitig. Wenn 
Sie an eine bestehende und schon einmal geschlossene sequentielle Datei 
Daten anfügen wollen, dürfen Sie diese Datei nicht einfach zum Schreiben 



5-8 


Arbeiten mit Dateien und Geräten 


öffnen. Das würde nämlich die vorher dort gespeicherten Daten zerstören. 
Verwenden Sie in diesem Fall den Anfüge-Modus (s. OPEN-Anweisung in 
Kapitel 9). 


Amiga Basic erlaubt die Angabe einer bestimmten Dateipuffergröße bei 
sequentiellen Dateien. Voreingestellt sind hier 128 Bytes. Die Puffergröße wird 
in der OPEN-Anweisung angegeben. Sie ist unabhängig von der Länge der zu 
lesenden oder zu schreibenden Datensätze und hat nur Einfluß auf die 
Verarbeitungsgeschwindigkeit. Größere Puffer erhöhen sie, verbrauchen an¬ 
dererseits aber auch mehr Hauptspeicherplatz. 


Die folgenden Anweisungen und Funktionen werden bei der Arbeit mit 
sequentiellen Dateien verwendet: 


CLOSE 

EOF 

INPUT# 

INPUTS 

LINE INPUT# 

LOC 

LOF 


OPEN 

PRINT 

PRINT# 

PRINT# USING 

WIDTH 

WRITE 


Eine sequentielle Datei erzeugen Das unten angegebene kleine Beispiel¬ 
programm zeigt, wie mit Amiga Basic eine sequentielle Datei mit Namen 
DATEN erzeugt wird und mit Daten, die über die Tastatur eingebene werden, 
gefüllt wird. 


Programm 1: Erzeugen einer sequentiellen Datei 

OPEH "DATEN" FOR OUTPUT fiS #1 

E inga.be : 

INPUT "Name (' ENDE' zum Beenden)"; N$ 

I F N$="ENDE" THEN GOTO Fertig 
INPUT "Abtei Iung"; ABT$ 

INPUT "Einstei Iungsdatum"; EINDAT$ 
WRITE II, N$, ABT$, EI NDAT$ 

PRINT 

GOTO Eingabe 
Fertig: 

CLOSE #1 
END 
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Wie im Beispiel gezeigt, werden folgende Programmschritte benötig, um eine 
sequentielle Date zu erzeugen und Daten abzulegen: 

1. Die Datei für Ausgabe öffnen. 

2. Daten mit der WRITE #-Anweisung in die Datei schreiben. 

3. Am Ende der Datenübertragung die Datei schließen. 

Mit Hilfe der PRINT# USING-Anweisung können die Daten für die Ausgabe 
formatiert werden. Z.B. können mit der Anweisung 

PRINT81, USING"##tt#.#lt,";fi,B,C,D 

numerische Daten in die Datei geschrieben werden, wobei die einzelnen 
Datenelemente mit Kommata voneinander getrennt werden. Dies geschieht 
durch die Angabe des Kommas am Ende der USING-Formatzeichenkette. Es 
sollten grundsätzlich Trennzeichen zum Trennen von Datenelementen ver¬ 
wendet werden, um das Lesen der Daten zu vereinfachen. 

Wenn Sie Kommata als Trennzeichen zwischen Datenelementen einfügen 
wollen, ohne sie extra anzugeben, können Sie auch die WRITE#-Anweisung 
verwenden. Z.B. 

WRITE <11, fi, B$ 

Hier wird zwischen den Werten der beiden Variablen ein Komma in die Datei 
eingefügt. 

Daten aus einer sequentiellen Datei lesen In einem weiteren Beispielpro¬ 
gramm sehen Sie, wie die Daten aus der Datei DATEN, die mit dem ersten 
Beispielprogramm erzeugt wurde, gelesen werden. Es sollen aber nur die 
Namen der Beschäftigten angezeigt werden, die im Jahre 1985 eingestellt 
wurden. 


Programm 2: Aus einer sequentielle Datei lesen 

OPEN"I", #1, "DATEN” 

WHILE NOT EOF(11 

INPUT ttl,N$, ABT$, EINDAT$ 

IF RIGHT$C EINDf»T$,2) = "85" THEN PRINT N$ 


WEND 
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Es wird jedes Datenelement sequentiell gelesen und daraufhin untersucht, ob 
am Ende die Zahl 85 steht. Nur dann wird der Name angezeigt. Die Steuer¬ 
schleife WHILE. . WEND verwendet vor jedem Lesevorgang die EOF-Funkti- 
on, um auf das Dateiende zu prüfen. Damit wird verhindert, daß ein Fehler 
auftritt, wenn versucht wird, über das Dateiende hinaus zu lesen. 

Daten an eine sequentielle Datei anfügen Einer existierenden sequentiellen 
Datei können nicht einfach Daten hinzugefügt werden, indem die Datei für 
Ausgabe geöffnet wird. Dies würde nämlich die vorhandenen Daten zerstören. 
Statt dessen müssen Sie den Anfüge-Modus verwenden. Falls die Datei nicht 
vorher existiert hat, arbeitet der Anfügemodus genau wie der normale 
Ausgabemodus. 


Programm 3: Daten sequentiell anfügen 

OPEN "A'Mtl, "PERSONEN” 

REM ****** Hinzufügen neuer Personendaten 
Neueingabe : 

INPUT ”Name";N$ 

IF N$=”" THEN GOTO Fertig ’ RETURN zum Beenden 
LINE INPUT "Adresse? ";ADR$ 

LINE INPUT "Geburtstag? GEB$ 

PRINT ttl j N$ 

PRINT Kl, ADR$ 

PRINT ttl,GEB$ 

GOTO Neueingabe 
Fertig: 

CLOSE ttl 
END 

Zur Eingabe der Adresse oder des Geburtstages wird die LINE INPUT-Anweisung 
verwendet, weil bei ihr Trennzeichen wie z.B. Kommata als zu den Eingabedaten 
gehörig akzeptiert werden. 


Direktzugriff s-Dateien 

Die Erzeugung und der Datenzugriff bei Direktzugriffsdateien benötigen mehr 
Programmmschritte als jene bei sequentiellen Dateien. Die Verwendung von 
Direktzugriffsdateien hat jedoch einige gravierende Vorteile. So benötigen 
diese Dateien weniger Speicherplatz auf der Diskette, da numerische Daten im 
gepackten Binärformat gespeichert werden, bei sequentiellen Dateien jedoch 
grundsätzlich als Folge von ASCII-Zeichen. 
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Der größte Vorteil der Direktzugriffsdateien gegenüber den sequentiellen 
Dateien besteht aber darin, daß auf jeden beliebigen Datensatz der Datei 
direkt zugegriffen werden kann. Es ist also nicht notwendig, erst alle Informa¬ 
tionen vom Dateianfang her zu überlesen, bis der gewünschte Datensatz 
erreicht ist, wie dies bei sequentiellen Dateien erforderlich ist. Dies wird 
dadurch ermöglicht, daß die Information in numerierten Datensätzen gespei¬ 
chert wird. Die Satznummer stellt also die Beziehung zwischen der Informati¬ 
on selbst und deren Platz auf der Diskette her. 

Folgende Anweisungen und Funktionen werden bei der Arbeit mit Direkzu- 
griffsdateien verwendet: 


CLOSE 

GET 

MKL$ 

CVD 

LOC 

MKS$ 

CVI 

LOF 

OPEN 

CVL 

LSET 

PUT 

CVS 

MKD$ 

RSET 

FIELD 

MKI$ 



Eine Direktzugriffsdatei erzeugen Wie bei den sequentiellen Dateien soll 
auch hier an einem Beispielprogramm gezeigt werden, wie eine Direktzugriffs¬ 
datei erzeugt wird und wie Daten hineingeschrieben werden. 


Programm 4: Erzeugung einer Direktzugriffsdatei 

OPEN"R”,«1,"DfiTEN” , 32 
FIELD ttl, 20 AS N$, 4 AS B$, 8 AS T$ 

Start: 

INPUT "Zueistel 1. Persona lnr. (—1 Für Ende ; CODES? 
IF CODE^=-l THEN Fertig 
INPUT "Name: ";PERSON$ 

INPUT"Betrag:”;BETR 
INPUT '*Te I. : ”; TEL$ 

PRINT 

LSET N$ = PERSON$ 

LSET B$ = MKS$( BETR ) 

LSETT$=TEL$ 

PUT #1, CODE* 

GOTO Start 
Fertig: 

CLOSE ttl 
END 
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Die Erzeugung einer Direktzugriffsdatei mit Daten erfolgt also mit folgende 
Programmschritten: 

1. Die Datei wird für direkten Zugriff (“R“ = Random access) geöffnet. Wird 
nicht, wie im Beispiel geschehen, die Satzlänge explizit angegeben, so 
wird eine Länge von 128 Bytes angenommen. 

2. Der Datenpuffer für die Datei wird mit der FIELD-Anweisung in Felder 
unterteilt, damit die zu speichernden Werte der einzelnen Variablen bei 
jedem Datensatz an eine definierte Stelle gespeichert werden. Über 
diesen Puffer werden die Programmdaten in die Datei geschrieben oder 
aus ihr gelesen. Im obigen Beispiel also: 

FIELD!I1,Z0 ASN$ 

3. Mit der LSET-Anweisung werden die zu speichernden Daten in den Puffer 
übertragen. Numerische Werte müssen dabei mit Hilfe z.B. der 
MKS$-Funktion als Zeichenkette interpretiert werden, also gewisserma¬ 
ßen als binäre Zeichenkette. Für die verschiedenen Darstellungsweisen 
numerischer Werte gibt es verschiedene MKx$-Funktionen. MKS$ dient 
zur Interpretation von einfachgenauen Gleitpunktwerten. 

Im obigen Beispiel waren die zu speichernden Daten: 

LSET N$=PERSOM$ 

LSET B$=MKS$(BETR ) 

LSET T$=TEL$ 

4. Um die Daten aus dem Puffer auf die Diskette zu schreiben, benutzt man 
die PUT-Anweisung, bei der man auch eine Satznummer angeben kann. 
Im obigen Beispiel: 

PUT ttl, CODEX 

In dem Beispielprogramm 4 werden also Informationen über die Tastatur 
eingeben und in einer Direktzugriffsdatei gespeichert. Die zweistellige Perso¬ 
nalnummer, die in der Ganzzahlvariablen CODE% gespeichert wird, dient als 
Satznummer für die PUT-Anweisung. 

Achtung: Variablennamen, die Sie in einer FIELD-Anweisung zur Aufteilung 
des Datenpuffers in Felder verwendet haben, dürfen Sie nicht z.B. in einer 
INPUT- oder LET-Anweisung verwenden. Andernfalls wird die Zuordnung 
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zum Datenpuffer aufgehoben und die Variable wird wie eine normale Pro¬ 
grammvariable behandelt. 

Daten aus einer Direkzugriffsdatei lesen Im nächsten Beispielprogramm 
wird gezeigt, wie aus der mit Programm 4 erzeugten Direktzugriffsdatei 
beliebige Datensätze gezielt gelesen werden können. 


Programm 5: Lesen aus einer Direktzugriffsdatei 

OPEN "R" , Kl/’DflTEH" , 32 
FIELD #1,20 fiS N$, 4 AS B$, 8 8ST$ 

Start: 

INPUT "Zueistell . Personalnr. (-1 f Ur Ertde)"j CODE% 

IF CODE%=-l THEN Fertig 
GET #1, CODE* 

PRINT N$ 

PRINT USING «#"; CUS(B$) 

PRINT T$: PRINT 
GOTO Start 
F ertig: 

CLOSE Ul 
END 

Der Zugriff auf Daten in einer Direktzugriffsdatei erfolgt also mit folgenden 
Programmschritten: 

1. Die Datei wird für direkten Zugriff eröffnet. 

2. Der Datenpuffer für die Datei wird mit der FIELD-Anweisung in Felder 
unterteilt, damit die zu lesenden Werte einzelnen Variablen zugewiesen 
werden können. Weitere Einzelheiten zur FIELD-Anweisung finden Sie bei 
der Erklärung des Programmbeispiels 4 weiter oben sowie in Kapitel 9. 

Achtung: Bei vielen Programmen, die Daten-Ein- und -Ausgabe für ein 
und dieselbe Direktzugriffsdatei enthalten, genügt meistens eine OPEN- 
und eine FIELD-Anweisung. 

3. Um den gewünschten Datensatz in den Datenpuffer zu lesen, wird die 
GET-Anweisung verwendet. 

Sobald die Daten im Datenpuffer stehen, kann das Programm über die in der 
FIELD-Anweisung verwendeten Variablen mit den Daten arbeiten. Numeri¬ 
sche Werte, die mit Hilfe der MKx$-Funktionen für die Speicherung als binäre 
Zeichenketten interpretiert wurden, können jetzt umgekehrt mit Hilfe der 



5-14 


Arbeiten mit Dateien und Geräten 


CVx-Funktionen wieder als numerische Werte behandelt werden. Im obigen 
Beispiel wird der im Datenpuffer als binäre Zeichenkette B$ eingelesene Wert 
mit Hilfe der CVS-Funktion als einfachgenauer numerischer Wert interpretiert. 

Mit Hilfe der LOC-Funktion erhält man bei Direktzugriffsdateien die aktuelle 
Satznummer. Das ist die Satznummer, die bei der letzten ausgeführten GET- 
oder PUT-Anweisung verwendet wurde. Z.B. beendet die Anweisung 

IF LOCC 1 )>50 THEN END 

das Programm, wenn die aktuelle Satznummer für die Datei # 1 größer als 50 
ist. 

Datenverarbeitung mit Direktzugriffsdateien Das folgende Programm illu¬ 
striert für einen konkreten Anwendungsfall die Datenverarbeitung mit einer 
Direktzugriffsdatei. 


Programm 6: Inventur 

Im Gegensatz zu den vorhergehenden Beispielen werden bei diesem Pro¬ 
gramm wieder Zeilennummern verwendet, um zu zeigen, daß Amiga Basic 
auch solche “herkömmlichen“ Basic-Programme interpretieren kann. 


Programm 6: Lagerhaltung 

120 OPEN "R", *1, "LAGER. DOT", 39 

125 FIELD #1, 1 fiS F$, 30 flS D$,2 AS Q$, 2 OS R$, 4 fiS P$ 

130 CLS:PRI NT I PR I NT "Programmf unkt i onen - " : PRI NT 
135 PRI NT " 1: Date i einr ichter»" 

140 PRINT ”2 • Neuen Eintrag erste I len" 

150 PRI NT ”3 I Lagerbest and für* ein Teil anzei gen*' 

160 PRINT ”4: Lagerbestand auf stocken" 

170 PRI NT ”5 : Entnahme aus dem Lager" 

180 PRI NT "6: Lager best aende unter Neubestei 1 schwe Ile 
anzeigen" 

190 PRI NT *'7: Programmende 

220 PRINT: PR INT: 1NPUT ''Welche Funkt ion"; FUNK 
225 1F ( FUNK< 1 ) OR C FUNK>7 ) THEN PRI NT "Fal sehe 
Funktion”:BEEP:FOR 1 = 1 TO 500: NEXT: GOTO 130 
230 ON FUNK GOSUB 900, 250, 390, 480,560, 680,970 
240 GOTO 130 

250 REM Neuen E in trag erste 1 len 
260 GOSUB 840 
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Programm 6: Lagerhaltung (Fortsetzung) 

270 IF BSC(F$X>255THEN 1 NPUT "Ersetzen <j2n8$ : 

IF 8$ 

280 LSET F$ = CHR$ (0) 

290 1 NPUT "Beze ichnung desTeils"; BEZ$ 

300 LSET D$=BEZ$ 

310 INPUT "Stückzahl" ;MSE 
320 LSETQ$=MK1$(M%) 

330 I NPUT "Neubeste 11 schwe Ile”; NS% 

340 LSET R$=MKI $( NS* ) 

350 I NPUT "Stueckpre i s” ; STP 
350 LSET P$=MKS$( STP ) 

370 PUT Itl, TEI L* 

380 RETURN 

390 REM Datensatz anzeigen 
400 GOSUB 840 

410 IF ftSC(F$) = 255THEN PRINT "Kein Eintrag" : RETURN 
420 PRINT USING "Teilenummer Ittttt” ; TEI L* 

430 PRINT D$ 

440 PRINT USING "Lagerbestand ttlttttttt”;CUI(Q$) 

450 PRINT USING "Nachbestellschwelle ttlttttttt”; CU 1 ( fl$ ) 
460 PRINT USING "Stueckpreis DM tttt . tttt” ; CUS< P$ ) 

465 FOR 1 = 1 TO 3000: NEXT 
470 RETURN 

480 REM Lagerbestand auf stocken 
490 GOSUB 840 

S00 IF ftSC(F$) = Z55THEN PRINT "Kein Eintrag” : RETURN 
510 PRINT D$: INPUT "Menge Zugang'';HZ 
520 Q3£=CUI(Q$)*fl^ 

530 LSET Q$=MKI $( Q% ) 

540 PUT tt 1 j TEI LX 
550 RETURN 

560 REM Entnahme aus dem Lager 
570 GOSUB 840 

580 IF 8SC(F$) = 25STHEN PRINT "Kein Eintrag" : RETURN 
590 PRINT D$ 

600 I NPUT "Menge Entnahme''; S* 

610 Q*=CUI(Q$) 

620 IF ( qss-S« X0THEN PRINT "Nur noch"Q«"Tei leauf 
Lager":GOTO 600 

630 Q*=Q*-S* 

640 1FQ*<=CUI ( R$ ) THEN PRINT ”Bestand jetzVQ* 

”Nachbeste11schweIleist"CUI(R$) 

650 LSET Q$=MKI$CQ*) 

660 PUT Itl,TEIL* 

665 FOR I = 1 TO 3000 : NEXT 
670 RETURN 

680 REM Tei le unter Neubeste 1 lschuel le anzeigen 
690 FOR 1 = 1 TO 100 
710 GET Itl, I 
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Programm 6: Lagerhaltung (Fortsetzung) 

720 IFCUI (q$HCUI<R$)THENPmHTD$"Menge"CUI(q$) 
TABC 50 ) "Neubeste 1 1 schwe 1 1 e''CU I(H$) 

730 NEXT 
740 RETURN 

840 INPUT "Tei 1 enummer" J TE1 La? 

8501F CTE1L%<1)OR(TEIL%>100)THEN PRINT"Falsche 
Tei lenummer" : GOTO 840 ELSE GET ttl,TEIL%: RETURN 
900 REM Datei einrichten 

910 INPUT "Sind Sie sicher ( IF B$<>" j" AND 

B$<>” J" THEN RETURN 
920 LSET F$=CHR$<255) 

930 FOR 1 = 1 TO 100 
940 PUT #1, I 
950 NEXT 
950 RETURN 
970 CLOSE:END 


Hauptprogramm; Zeilen 120-240 

Das Hauptprogramm eröffnet die Datei, zeigt ein Menü mit den vorhandenen 
Programmfunktionen auf dem Bildschirm an und verzweigt in die vom Anwender 
gewählte Subroutine. 

Zeile 120 Die Datei LAGER.DAT wird für wahlfreien Zugriff mit einer Satzlänge 
von 39 Bytes eröffnet und ihr wird der Puffer 1 zugeordnet. 

Zeile 125 Die Felder des Dateipuffers werden nach Name und Länge definiert. F$ 
ist 1 Byte, D$ ist 30 Bytes, Q$ ist 2 Bytes, Ft$ ist 2 Bytes und P$ ist 4 Bytes lang. 

Zeilen 130-190 Das Menü für die Auswahl einer Programmfunktion wird ange¬ 
zeigt. 

Zeilen 220-225 Vom Anwender wird eine Eingabe gefordert, die auf Gültigkeit 
geprüft wird. Ist sie ungültig, wird eine Fehlerverzweigung angezeigt und der 
Anwender wird an das Menü zurückverwiesen. 

Zeile 230 Verzweigt abhängig vom eingegebenen Wert zur gewünschten Sub¬ 
routine (1 verzweigt nach Zeile 900, 2 nach Zeile 250 usw.). 

Zeile 240 Nach Rückkehr aus der gewählten Subroutine wird der Anwender 
wieder an das Menü verwiesen (Zeile 130). 
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Subroutine für die Erstellung neuer Einträge; Zeilen 250-380 

Zunächst wird geprüft, ob der betreffende Satz nicht schon Daten enthält. Dann 
wird der Anwender zur Dateneingabe aufgefordert, und schließlich wird der neue 
Satz in die Datei geschrieben. 

Zeile 260 Verzweigung zur Subroutine, die die Eingabe der gewünschten 
Teilenummer (und damit Satznummer) fordert und den so spezifizierten Satz von 
Disk liest. 

Zeile 270 Das erste Zeichen des spezifizierten Satzes wird geprüft. Ist es nicht 
CHR$(255) (damit werden in der Subroutine ab Zeile 900 anfänglich alle Sätze der 
Datei eingerichtet), so muß der Anwender entscheiden, ob er den Satz, der ja dann 
nicht leer ist, ersetzen will. Falls nicht, wird zum Hauptprogramm zurückverzweigt. 

Zeile 280 Das erste Byte im Satz wird mit CHR$(0) überschrieben, um zu zeigen, 
daß der Satz jetzt Daten enthält. 

Zeilen 290-300 Vom Anwender wird die Eingabe der Bezeichnung für das neue 
Teil gefordert, die dann in die für D$ im FIELD-Puffer reservierten 30 Bytes 
übertragen wird. 

Zeile 310 Vom Anwender wird die Eingabe der Stückzahl gefordert. 

Zeile 320 Die Stückzahl wird in die dafür im FIELD-Puffer unter Q$ reservierten 2 
Bytes übertragen. Da es sich um numerische Daten handelt, müssen sie vorher 
mit der MKI$-Funktion als Zeichenkette behandelt werden. 

Zeilen 330-340 Vom Anwender wird die Eingabe der Nachbestellschwelle 
gefordert, die ebenfalls als Zeichenkette interpretiert und in die unter R$ reser¬ 
vierten 2 Bytes im FIELD-Puffer übertragen wird. 

Zeilen 350-360 Vom Anwender wird die Eingabe eines Stückpreises gefordert, 
der hier mit Hilfe der MKI$-Funktion als Zeichenkette interpretiert wird, da es sich 
um einen einfachgenauen Wert mit Dezimalstellen, also keinen ganzzahligen Wert 
wie bei Q$ und R$, handelt. Der Stückpreis wird mit 4 Byte Länge unter P$ im 
FIELD-Puffer abgelegt. 

Zeile 370 Der Pufferinhalt wird als Satz auf Disk geschrieben. Die Teilenummer 
dient dabei als Satznummer. 


Zeile 380 Es wird zurück ins Hauptprogramm verzweigt. 
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Subroutine für die Anzeige eines Satzes; Zeilen 390-470 

Diese Subroutine prüft zunächst, ob der spezifizierte Satz Daten enthält. Dann 
werden die Inhalte aller Felder formatiert angezeigt. 

Zeile 400 Verzweigung zur Subroutine, die die Eingabe der gewünschten 
Teilenummer (und damit Satznummer) fordert und den so spezifizierten Satz von 
Disk liest. 

Zeile 410 Es wird geprüft, ob der spezifizierte Satz Daten enthält. 

Zeilen 420-460 Die Inhalte der Satzfelder werden mit Hilfe der PRINT USING-An- 
weisung formatiert auf dem Bildschirm angezeigt. Numerische Werte, die als 
Zeichenketten auf Disk gespeichert waren, werden dabei mit Hilfe der CVI- und 
CVS-Funktionen wieder als numerische Werte interpretiert. 

Zeile 470 Es wird zurück ins Hauptprogramm verzweigt. 


Subroutine für die Lageraufstockung; Zeilen 480-550 

Zunächst wird wieder geprüft, ob der spezifizierte Satz Daten enthält. Dann wird 
vom Anwender die Eingabe der Anzahl gefordert, um die der Lagerbestand des 
spezifizierten Teils aufgestockt werden soll. Um diese Anzahl wird dann der 
Bestand erhöht. 

Zeile 490 Verzweigung zur Subroutine, die die Eingabe der gewünschten 
Teilenummer (und damit Satznummer) fordert und den so spezifizierten Satz von 
Disk liest. 

Zeile 500 Es wird geprüft, ob der spezifizierte Satz Daten enthält. 

Zeile 510 Zeigt die Teil-Bezeichnung auf dem Schirm an und fordert die Eingabe 
der Anzahl, um die der Lagerbestand für das betreffende Teil aufgestockt werden 
soll. 

Zeile 520 Der Lagerbestand wird durch Addition erhöht. Dazu muß vorher der als 
Zeichenkette gespeicherte alte Bestand (Q$) als Ganzzahlwert mit Hilfe der 
CVI-Funktion interpretiert werden. 

Zeile 530 Der neue Lagerbestand (Q%) wird wieder als Zeichenkette interpretiert 
und im Feld Q$ des FIELD-Puffers gespeichert. Der dort vorher gespeicherte alte 
Bestand wird dabei überschrieben. 
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Zeile 540 Der Pufferinhalt wird als Satz zurück auf die Disk geschrieben. Der alte 
Satz wird dabei überschrieben. 

Zeile 550 Es wird zurück ins Hauptprogramm verzweigt. 


Subroutine für die Entnahme aus dem Lager; Zeilen 560-670 

Zunächst wird wieder geprüft, ob der spezifizierte Satz Daten enthält. Dann wird 
vom Anwender die Eingabe der Anzahl der spezifizierten Teile gefordert, die vom 
Lager entnommen werden sollen. Dabei wird geprüft, ob der Lagerbestand dafür 
ausreicht. Nach der Bestandsverminderung wird außerdem geprüft, ob die 
Nachbestellschwelle unterschritten ist. Der neue Lagerbestand für das spezifizier¬ 
te Teil wird zurück auf Disk geschrieben. 

Zeile 570 Verzweigung zur Subroutine, die die Eingabe der gewünschten 
Teilenummer (und damit Satznummer) fordert und den so spezifizierten Satz von 
Disk liest. 

Zeile 580 Es wird geprüft, ob der spezifizierte Satz Daten enthält. 

Zeile 590-600 Die Teil-Bezeichnung wird auf dem Schirm angezeigt, und es wird 
die Anzahl der spezifizierten Teile gefordert, die vom Lager entnommen werden 
sollen. 

Zeile 610 Der alte Bestand, der als Zeichenkette Q$ gespeichert war, wird als 
Ganzzahlwert interpretiert und der Variablen Q% zugewiesen. 

Zeile 620 Es wird geprüft, ob der Lagerbestand des spezifizierten Teiles die 
gewünschte Entnahme erlaubt. Falls nicht, wird nach einer Fehlermeldung zur 
Mengeneingabe (Zeile 600) zurückverzweigt. 

Zeile 630 Der Lagerbestand wird durch Subtraktion vermindert. 

Zeile 640 Es wird geprüft, ob jetzt die Nachbestellschwelle erreicht oder 
unterschritten ist. Falls ja, wird der Anwender durch eine Meldung darauf 
hingewiesen. 

Zeile 650 Der neue Lagerbestand (Q%) wird als Zeichenkette interpretiert und 
wieder bei Q$ im FIELD-Puffer gespeichert. 

Zeile 660 Der Pufferinhalt wird als Satz zurück auf Disk geschrieben. Der alte Satz 
wird dabei überschrieben. 
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Zeile 670 Es wird zurück ins Hauptprogramm verzweigt. 


Subroutine zur Anzeige aller Teile, deren Anzahl 
unter der Nachbestellschwelle liegt; Zeilen 680-740 

Diese Subroutine liest in einer Schleife jeden Satz und vergleicht den Bestand mit 
der für dieses Teil festgelegten Nachbestellschwelle. Liegt der Bestand unter der 
Nachbestellschwelle, wird eine entsprechende Meldung angezeigt. 

Zeile 690 Es wird eine Programmschleife für alle Teilenummern eingerichtet, die 
die Programmzeilen 690 bis 730 umfaßt. 

Zeile 710 Ein Satz wird von Disk in den Puffer gelesen. 

Zeile 720 Bestand und Nachbestellschwelle werden für das betreffende Teil 
verglichen. Liegt der Bestand unter der Nachbestellschwelle, wird eine Meldung 
angezeigt. 

Zeile 730 Der Schleifenzähler wird erhöht und die Schleife wird wiederholt. 

Zeile 740 Nach hundert Schleifendurchläufen wird ins Hauptprogramm zurück¬ 
verzweigt. 


Subroutine zum Einlesen des gewünschten Satzes; Zeilen 840-850 

Diese Subroutine dient zum Einlesen individueller Sätze aus der Datei. Sie wird von 
jeder anderen Subroutine angesprungen, in der die Daten des gewünschten 
Satzes verändert werden. 

Zeile 840 Vom Anwender wird die Eingabe der gewünschten Teilenummer (und 
damit Satznummer) gefordert. 

Zeile 850 Wenn eine ungültige Teilenummer (kleiner als 1 oder größer als 100) 
eingegeben wurde, wird eine Meldung angezeigt, und die Eingabe muß wiederholt 
werden (Zeile 840). Andernfalls wird der spezifizierte Satz von Disk gelesen und 
zurückverzweigt. 
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Subroutine zum Einrichten der Datei; Zeilen 900-960 

Diese Subroutine richtet die Lagerdatei ein, indem als erstes Zeichen jedes Satzes 
CHR$(255) eingetragen wird. Damit wird der Satz als leer gekennzeichnet. 

Zeile 910 Der Anwender muß bestätigen, daß er die Datei neu einrichten will. Hier 
kann er die Subroutine noch verlassen, ohne die Datei zu verändern. 

Zeile 920 Die Kennung für leere Sätze (CHR$(255)) wird in die erste Stelle des 
FIELD-Puffers eingetragen. 

Zeilen 930-950 In einer Schleife werden alle Sätze mit dem Inhalt des Puffers 
beschrieben. 

Zeile 960 Es wird ins Hauptprogramm zurückverzweigt. 


Programmende 

Zeile 970 Die Datei wird geschlossen und die Programmausführung wird 
beendet. 


5.5 Datenaustausch zwischen Amiga Basic und Textprogrammen 

Wie Sie vielleicht wissen, erzeugen Textprogramme gewöhnlich Dateien, in denen 
nicht nur sichtbare Zeichen, sondern auch Spezialzeichen für die Textformatsteue¬ 
rung enthalten sind, und die nicht sichtbar sind. Solche Zeichen können, wenn mit 
dem Textprogramm ein Amiga Basic-Programm geschrieben wurde, das Pro¬ 
gramm für den Interpreter unlesbar machen. 

Nun verfügen die meisten Textprogramme über einen wählbaren Modus, in dem 
reine Textdateien ohne jede Steuerzeichen erstellt aber auch gelesen werden 
können. 

Wenn Sie andererseits ein Programm mit Amiga Basic erstellen und es später für 
eine Veröffentlichung mit einem Textprogramm weiter bearbeiten wollen, spei¬ 
chern Sie es mit dem SAVE-Befehl unter Verwendung der A-Option. Dann wird 
das Programm im ASCII-Format, also im Klartext, gespeichert, das von den 
meisten Textprogrammen gelesen werden kann. 
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6. Besonderheiten von Amiga Basic 


Amiga Basic verfügt über einige Programmierungsbesonderheiten wie Unterpro¬ 
gramme, Unterbrechungsreaktionsfähigkeit und Speicherverwaltung. Diese lei¬ 
stungsfähigen Eigenschaften, die vom Anfänger nicht unbedingt verstanden 
werden müssen, erhöhen die Flexibilität von Amiga Basic erheblich. Sie sind 
speziell für den fortgeschrittenen Programmierer hilfreich, der Programme für 
professionelle Anwendungen entwickelt. 

Unterprogramme sind Module, die den herkömmlichen Subroutinen stark ähneln, 
gegenüber diesen jedoch erhebliche Vorteile aufweisen. Programmierer, die ihre 
Programme aus Moduln zusammensetzen, die auch in anderen Programmen 
Anwendung finden sollen, werden sich dieser Technik gerne bedienen. 

Die Unterbrechungsreaktionsfähigkeit erlaubt einem Programm die Übergabe der 
Programmsteuerung an eine bestimmte Zeile, sobald ein bestimmtes Ereignis 
eintritt, wie z.B. Zeitablauf, Maus-Aktivitäten, Programmunterbrechung durch den 
Anwender oder Menü-Auswahl. 

Mit Hilfe des CLEAR-Befehls und der FRE-Funktion kann der Anwender von 
seinem Programm aus den Amiga Basic-Arbeitsspeicher in gewissem Sinne 
verwalten und z.B. auch große Programme, bei denen es sonst Speicherkapazi¬ 
tätsschwierigkeiten geben kann, ablaufen lassen. 

Die Amiga-Bibliotheksroutinen sind Maschinensprache-Routinen, die beim Star¬ 
ten des Rechners automatisch in den Speicher geladen werden. Um jedoch eine 
spezielle Routine von einem Amiga Basic-Programm aus nutzen zu können, muß 
die entsprechende Bibliothek zunächst geöffnet werden. Nach dem Aufruf der 
Routine muß die Bibliothek wieder geschlossen werden. 


6.1 Unterprogramme 

Wie normale Subroutinen bestehen auch Unterprogramme aus einer Reihe von 
Programmzeilen. Es gibt jedoch drei wesentliche Vorteile gegenüber den Subrou¬ 
tinen: 

1. Unterprogramme verwenden lokale Variablen, also Variablen, die von den 
Variablen des Hauptprogramms isoliert sind. Wenn also ein Programmierer 
irrtümlich in einem Unterprogramm einen Variablennamen verwendet, der 
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bereits schon im Hauptprogramm existiert, so behalten beide Variablen ihre 
jeweiligen Werte. Der Wert einer Variablen im Unterprogramm kann also nicht 
vom Hauptprogramm aus verändert werden. 

2. Auch der zweite Vorteil bezieht sich auf die lokalen Variablen. Es geschieht 
häufig, daß ein Programmierer in verschiedenen Programmen eine bestimmte 
Programmroutine immer wieder neu schreibt und sie an die Variablen des 
jeweiligen Programms anpaßt. Da Amiga Basic eben lokale Variablen unter¬ 
stützt, empfiehlt es sich hier, einen Satz von Unterprogrammen mit festen 
lokalen Variablen zu schreiben, die in beliebigen Programmen ohne Änderung 
eingesetzt werden können, indem sie einfach mit dem MERQE-Befehl ange¬ 
fügt werden. 

3. Unterprogramme können nicht ungewollt ausgeführt werden, Subroutinen 
dagegen leicht, wenn vor dem Beginn keine END- oder eine ähnliche 
Anweisung steht, die Programmausführung also einfach mit der ersten Zeile 
der Subroutine fortgesetzt wird. Unterprogramme werden dagegen ohne 
CALL-Anweisung niemals ausgeführt. 


Der Aufruf von Unterprogrammen 

Unterprogramme werden mit der CALL-Anweisung (s. dort in Kapitel 9) sowie 
wahlweise einer Liste von zu übergebenden Argumenten aufgerufen. 

Im folgenden werden “Argumente“ und "formale Parameter“ unterschieden. 
Argumente sind Programmvariablen, die mit der CALL-Anweisung an das 
Unterprogramm übergeben werden. Z.B. 

CRLL STEUER«ZWISUM,MWST,GESfiMTSUMC )) 

Bei diesem Beispiel sind die beiden einfachen Variablen ZWISUM und MWST 
sowie die Feldvariable GESAMTSUM die Argumente. 

Formale Parameter dagegen beziehen sich auf die parallel vom Unterpro¬ 
gramm verwendeten Werte. Wenn z.B. das STEUER-Unterprogramm im 
obigen Beispiel aufgerufen wird und als erste Zeile 

SUB STEUERtBETRAG,STEUERSTUFE,SUMC1)) STOTIC 

enthält, so sind hier die Variablen BETRAG,STEUERSTUFE und SUM() formale 
Parameter. Diesen Parametern entsprechen (und werden übergeben) die als 
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Argumente verwendeten Hauptprogrammvariablen ZWISUM, MWST und GE- 
SAMTSUM. 

Die vom Hauptprogramm zum Unterprogramm und zurück transferierten 
Parameter werden als “durch Referenz übertragen“ bezeichnet. Das bedeu¬ 
tet: Wenn der formale Parameter vom Unterprogramm modifiziert wird, so 
ändert sich der Wert des Argumentes entsprechend. 

Dies kann den Wert von Variablen beeinflussen. Z.B.: 

coll rmniFRFCfi, b, o 


SUBADDIERE(X.VjZ) STfiTIC 
Z=X+Y 
X=X+12 
Y=Y+94 
END SUB 

Wenn z.B. die Werte der Variablen A und B beim Aufruf des Unterprogramms 
ADDIERE durch die CALL-Anweisung A = 2 und B = 3 sind, so haben sich 
diese Werte nach der Rückkehr ins Hauptprogramm geändert, da die Variable 
A an die Variable X und die Variable B an die Variable Y gekoppelt sind. Wenn 
sich nun der Wert von X im Unterprogramm ändert, wird der Wert von A 
ebenfalls verändert. Im obigen Beispiel wird A um 12 vergrößert, weil 
X = X + 12. X ist also die “Alias“-Variable zu A. 

Wenn Sie dagegen nicht wollen, daß die Werte von Hauptprogrammvariablen 
sich durch Unterprogrammoperationen ändern, setzen Sie die Variablen in der 
Argumentliste in Klammern. Dies erhält den Wert der Variablen, den sie beim 
Aufruf des Unterprogramms hatten, unabhängig von jeglichen Operationen im 
Unterprogramm. Also z.B.: 

CftLL ADDIEREC < ft ) , (B), SUM ) 

Die Klammern um die ersten beiden Variablen erheben diese in die Kategorie 
von Ausdrücken, und Ausdrücke können in Unterprogrammen nicht verändert 
werden. 

Wenn Sie dagegen ganze Ausdrücke an ein Unterprogramm übergeben 
wollen, benötigen Sie keine Klammern. Z.B.: 

CALL ADDIEREC 1+2,3~A, SUM 1 
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Beachten Sie aber, daß der Typ der Argumente mit dem Typ der formalen 
Parameter übereinstimmen muß. Andernfalls wird eine “Type mismatch“-Feh- 
lermeldung (fehlende Typübereinstimmung) angezeigt. Die Anweisungsfolge 

CALL UPROC 1) 

SUB UPROC X ) STHTI C 

ergibt eine Fehlermeldung, weil die ganze Zahl 1 der Gleitpunktvariablen 
einfacher Genauigkeit X übergeben wird. Diesen Fehler kann man mit 

CALL UPROC 1.0) 

SUB UPROC X ) STOTI C 

vermeiden. 


Unterprogramm-Begrenzung: Die SUB- und END SUB-Anweisungen 

Unterprogramme werden mit der SUB-Anweisung eingeleitet und mit der 
END SUB-Anweisung beendet. Zusätzlich kann aus einem Unterprogramm 
mit der EXIT SUB-Anweisung ausgesprungen werden, ehe die END SUB-An¬ 
weisung erreicht wird. Die END SUB- oder EXIT SUB-Anweisungen überge¬ 
ben die Programmsteuerung zurück an den aufrufenden Programmteil. Es gilt 
folgende allgemeine Syntax: 


SUB Name HL iste form. Par am. ) ] ST flT I C 
[SHARED Variablenliste] 


END SUB 

Für Name kann jeder beliebige Name bis zu einer Länge von 40 Zeichen nach 
den Amiga Basic-Namensregeln (s. Kapitel 8.3 und 8.5) gesetzt werden. 
Dieser Name darf dann jedoch nicht in irgendeiner anderen SUB-Anweisung 
verwendet werden. 

In Liste form. Param dürfen zwei Typen von Einträgen stehen: einfache 
Variablen und Feldvariablen. Bei der Verwendung von Feldvariablen berück¬ 
sichtigen Sie bitte die im nächsten Abschnitt angegebenen Regeln. Jeder 
Parameter wird vom nächsten durch ein Komma getrennt. Die Anzahl der 
Parameter wird nur durch die Maximallänge einer logischen Amiga Basic-Pro- 
grammzeile begrenzt. 
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Das Schlüsselwort STATIC besagt, daß alle Variablen im Unterprogramm ihre 
Werte zwischen zwei Unterprogrammaufrufen behalten. Die Werte von mit 
STATIC deklarierten Variablen können nicht vom Hauptprogramm verändert 
werden. Außerdem bedeutet die STATIC-Option, daß das betreffende Unter¬ 
programm nicht rekursiv ist, d.h. sich nicht selbst noch ein anderes Unterpro¬ 
gramm aufrufen darf, das dann seinerseits das aufrufende Unterprogramm 
wieder aufruft. 

Variablen, die mit der SHARED-Anweisung (s. dort in Kapitel 9) deklariert 
werden, dürfen auch außerhalb des Unterprogramms verändert werden. Alle 
Variablen, für die das gelten soll, müssen in der auf die SHARED-Anweisung 
folgenden Variablenllste deklariert werden. Grundsätzlich werden zunächst 
alle in einem Unterprogramm verwendeten einfachen oder Feldvariablen als 
lokal betrachtet, es sei denn, sie werden explizit mit einer SHARED-Anwei¬ 
sung umdefiniert. 

Die Anweisungen, die den Kern des Unterprogramms bilden, werden grund¬ 
sätzlich von den SUB- und END SUB-Anweisungen am Anfang und Ende 
begrenzt. 

In Unterprogrammen dürfen alle Amiga Basic-Befehle, -Anweisungen, -Funk¬ 
tionen und Systemvariablen verwendet werden, mit Ausnahme von: 

• anwenderspezifischen Funktionsdefinitionen. 

• Unterprogrammstrukturen. D.H. Unterprogramme können im Gegensatz 
zu Subroutinen nicht geschachtelt werden. 

• COMMON-Anweisungen. 

• CLEAR-Anweisungen. 


Verwendung der SHARED- und STATIC-Anweisungen in Unterprogrammen 

Variablen und Felder, auf die in Unterprogrammen Bezug genommen wird, 
oder die in diesen deklariert werden, gelten zunächst als lokal in diesem 
Unterprogramm. Amiga Basic erlaubt jedoch einerseits die Deklaration von 
globalen Variablen innerhalb eines Programms und andererseits den Erhalt 
von Werten über Unterprogrammaufrufe hinweg. 
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SHARED-Variablen Innerhalb eines Unterprogramms können Variablen des 
aufrufenden Hauptprogramms mit Hilfe der SHARED-Anweisung verwendet 
werden. In diesem Fall sind nur Variablen in dem Unterprogramm betroffen, in 
dem auch die SHARED-Anweisung verwendet wird. 


Ein Beispiel: 


LET 0=1: LET B=5: LET C= 10 
DIM P< 100), QC 100) 


SUB OMI GO STOTIC 

SHflRED n,B,PO,q() 


END SUB 

In diesem Beispiel werden alle Variablen des Hauptprogramms mit Ausnahme 
der Variablen C als mit dem Unterprogramm AMIGA gemeinsame Variablen 
deklariert. 

STATIC-Variablen Wie bereits erwähnt, werden Variablen und Felder, die in 
einem Unterprogramm deklariert werden oder auf die dort Bezug genommen 
wird, für dieses Unterprogramm als lokal angenommen. Sie können nicht 
durch das Hauptprogramm oder andere außerhalb liegende Programmteile 
verändert werden. Ohne Zuweisungen haben diese Variablen den Wert 0 bzw. 
sind eine Zeichenkette mit der Länge 0. Wird das Unterprogamm verlassen 
und dann neu aufgerufen, so haben die Variablen die Werte vom letzten 
vorausgegangenen Aussprung. 

Das Schlüsselwort STATIC wird bei allen Unterprogrammdefinitionen in Amiga 
Basic benötigt. 
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Parameterübergabe bei Unterprogrammen 

Einfache Variablen und Feldelemente Wenn eine einfache Variable, ein 
Feldelement oder ein ganzes Feld an ein Amiga Basic-Unterprogramm 
übergeben wird, so gilt diese Übergabe als durch Referenz übertragen. Im 
folgenden Beispiel wird gezeigt, wie dies funktioniert: 

DIU Bt 15) 

n=4 

CRLL QURDHIERECR, B(3)) 

PRINT R,B(3) 

END 

SUB QURDRI ERECX, Y) STRTIC 
X=X*1 
Y=X«X 
END SUB 

Dieses Beispiel erzeugt als Ergebnis die Ausgabe 5 und 25. Jede Bezugnahme 
auf die Variable Y im Unterprogramm QUADRIERE resultiert in einer Be¬ 
zugnahme auf das dritte Element des Feldes B, und jedesmal, wenn das 
Unterprogramm QUADRIERE die Variable X benutzt, wird auch A verändert. 

Deklaration von Feld-Variablen als Parameter Einfachen Variablen in einer 
Parameterliste dürfen beliebige gültige Amiga Basic-Namen gegeben wer¬ 
den. Wenn jedoch ein ganzes Feld übergeben werden soll, so muß dies 
folgendermaßen deklariert werden: 


Feldname([Dimensionen 1 ) 


Feldname ist dabei ein beliebiger gültiger Amiga Basic-Name. Für die optional 
angebbare Zahl von Dimensionen wird eine Ganzzahlkonstante deklariert. 
Beachten Sie, daß die aktuellen Dimensionen hier nicht angegeben werden. 

So sind z.B. in dem Unterprogramm 

CftlL MflTflDD2( XX, Y*,P< ),Q(),RO) 

END 


SUB MfiTfiDDC N%,M* # PIC2),BC2),C(3)) STftTIC 


END SUB 
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die Variablen N% und M% Ganzzahlvariablen. A und B sind als2-dimensionale 
Felder und C als 3-dimensionales Feld deklariert. In der entsprechenden 
Argumentliste im Hauptprogramm werden die Klammern nur zur Kennzeich¬ 
nung von Feldern benötigt. 

Funktionen zur Bestimmung von Feldbegrenzungen Die Unter- und Ober¬ 
grenze von Felddimensionen kann mit Hilfe der Funktionen LBOUND und 
UBOUND (s. dort in Kapitel 9) bestimmt werden. 

LBOUND liefert die Untergrenze einer Dimension, also je nach mit der OPTION 
BASE-Anweisung (s. dort in Kapitel 9) gestztem Wert 0 oder 1. Die voreinge¬ 
stellte Untergrenze für jede Dimension ist 0. UBOUND liefert die Obergrenze 
für die angegebene Dimension. 

Für beide Funktionen existiert eine allgemeine und eine verkürzte Syntax, 
letztere für eindimensionale Felder: 


LBOUND( Feld) 
LBOUND( Feld,Dim) 
UBOUND(FeJd) 
UBOUND( Feld,Dim ) 


für 1-dimensionale Felder 
für n-dimensionale Felder 
für 1-dimensionale Felder 
für n-dimensionale Felder 


Dabei müssen Feld ein gültiger Amiga Basic-Variablenname und Dim eine 
ganze Zahl zwischen 1 und der Maximalzahl der für das betreffende Feld 
vereinbarten Dimensionen sein. 


LBOUND und UBOUND sind hilfreiche Funktionen bei der Bestimmung der 
Größe eines Feldes, das an ein Unterprogramm übergeben werden soll. 

Ausdrücke als Argumente Wie bereits erwähnt, können auch Ausdrücke an 
Amiga Basic-Unterprogramme übergeben werden. Es dürfen hier beliebige 
gültige Amiga Basic-Ausdrücke mit Ausnahme von Referenzen auf einfache 
oder Feldvariablen verwendet werden. Findet der Interpreter in der Argument¬ 
liste einer CALL-Anweisung einen Ausdruck, so wird dieser einer temporären 
Variablen desselben Typs zugewiesen, die durch Referenz an das Unterpro¬ 
gramm übertragen wird. Dies ist praktisch derselbe Vorgang wie die Übergabe 
durch einen Funktionsaufruf über den Wert, wobei der Wert selbst übergeben 
wird. 


Wird eine einfache Variable oder ein Feldelement in Klammern eingeschlos¬ 
sen, so wird dies als Ausdruck interpretiert und wie ein Ausdruck übergeben 
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(also Funktionsaufruf mit Wertübergabe. Wenn also im obigen Beispiel die 
CALL QUADRIERE-Anweisung in 

CALL QUADRIERE ((fl),B(3)) 

geändert würde, würde als Ergebnis 4 und 25 angezeigt. In diesem Fall würde 
nämlich (A) als Ausdruck mit seinem Wert übergeben und das Unterpro¬ 
gramm könnte den Wert von A nicht ändern. 


6.2 Aufruf von Maschinensprache-Unterprogrammen 


Genau wie Amiga Basic-Unterprogramme werden werden auch Maschinenspra¬ 
che-Unterprogramme mit der CALL-Anweisung aufgerufen. Die Binärdatei des 
Unterprogramms wird in den Speicher gelesen und dann ruft die CALL-Anwei¬ 
sung das Unterprogramm mit einer einfachen Variablen, die die Startadresse des 
Unterprogramms enthält, auf. Hierfür darf kein Feldelement verwendet werden. 

Entsprechend den Unterprogrammaufruf-Konventionen der Programmiersprache 
C werden die Parameter mit ihrem Wert übergeben. Alle Parameter müssen vom 
Typ kurze oder lange Ganzzahl sein. Man kann aber auch die Adresse einer 
einfach- oder doppeltgenauen Gleitpunktvariablen mit Hilfe der VARPTR-Funkti- 
on oder die Adresse einer Zeichenkette mit Hilfe der SADD-Funktion (s. dort in 
Kapitel 9) übergeben. Beispielsweise werden mit dem Aufruf: 

CALL MeinProg( UARPTR< ZZ ) , SADD( A$ ) 

die Adressen der einfachgenauen Gleitpunktvariablen ZZ sowie der Zeichenket¬ 
tenvariablen A$ übergeben. 

Achtung : Es muß sichergestellt sein, daß die Maschinenroutine auf einer geraden 
Speicheradresse beginnt, sonst ist ein Systemabsturz unvermeidlich. 

Achtung: Felder sollten mit den oben beschriebenen Prozeduren nicht an 
Maschinensprache-Unterprogramme übergeben werden. Statt dessen sollte 
lieber das Basis-Element des Feldes durch Referenz übertragen werden, wenn im 
Unterprogramm auf das ganze Feld zugegriffen wird, also z.B. 

CALL XREF C UARPTR (AC0.0))) 


Hier wird das erste Element eines zweidimensionalen Feldes an das Maschinen¬ 
sprache-Unterprogramm bei Startadresse XREF übergeben. 
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Im folgenden wird der Aufruf eines Maschinensprache-Unterprogramms aus. 
einem Amiga Basic-Programm anhand eines Beispiels beschrieben. Zunächst 
das Maschinensprache-Unterprogramm, das eine Zeichenkette in Großbuchsta¬ 
ben wandelt: 


SECTION CODE 


48E7 

C080 


MOVEM.L 

A0/D0-D1-SP 

;Reg. retten 

202F 

0010 


MOVE.L 

16(SP),D0 

;Länge holen 

206F 

4281 

0014 


MOVE.L 

CLR.L 

20(SP),A0 

Dl 

;Adr. 1. Stringbyte 
;MSB von Dl 
löschen 

6000 

001C 

Start: 

BRA 

Test 

;Schleife testen 

1230 

0000 


MOVE.B 

0(A0,D0),D1 

; nächstes 

Stringbyte 

OC01 

6D00 

0061 

0010 


CMP.B 

BLT 

# ’a’.DI 

Test 

;wenn < a 

0C01 

007A 


CMP.B 

# ’Z’.DI 

;oder > z 

6E00 

0008 


BGT 

Test 

;so lassen 

0230 

00DF 

0000 

Test: 

AND.B 

#($FF-$20),0(A0,D0) 

;sonst wandeln 

51C8 

FFE4 


DBF 

DO,Start 

;Zaehler dekrement. 

4CDF 0103 
4E75 


MOVEM.L 

RTS 

(SP) + .A0/D0-D1 

;Register laden 
;Rueckkehr nach 
Basic 


Die von der Routine verwendeten Parameter werden zum Zeitpunkt des Aufrufes 
auf dem Stapel abgelegt; für das o.a. Unterprogramm CODE in der folgenden 
Ordnung: 


Offset 

8 (SP) (SP = Stapelzeiger) 
4 (SP) 

0 (SP) 


Zeichenketten-Adresse (adr&) 
Zeichenketten-Länge (laeng&) 
Rückkehradresse 
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Nach dem Ablegen der Register AO, DO und Dl auf dem Stapel ist dessen Status 
folgendermaßen: 


Zeichenketten-Adresse (adr&) 

Offset 

20 (SP) 

Zeichenketten-Länge (laeng&) 

16 (SP) 

Rückkehradresse 

12 (SP) 

AO 

8 (SP) 

Dl 

4 (SP) 

DO 

0 (SP) 


Als nächstes wird das Amiga Basic-Programm gezeigt und beschrieben, das das 
o.a. Maschinensprache-Unterprogramm lädt, aufruft und die gewandelte Zeichen¬ 
kette anzeigt: 

Uli DTH 70 

OPEN "CODE” FOR INPUT OS 1 
GrossCode$=INPUT$C LOF(1) , 1) 

CLOSE 1 

INPUT "Text in Grop-/Kleinschreibung eingeben: ", st$ 

GOSUB Aufruf 
END 


Aufruf: 

Wand 1 bä=SADD(G rossCode$) 

PRINT Wand I cd ' Hier- nur zur Kontro I le 

IF Wand IeÄ HMD 1THEN GrossCode$=GrossCode$+" ":GOTO Hufruf 

adr&=SADD(st$) 

laengft=LEN <st$) 


CfiLL Wand left( laertgÄ, adrÄ ) 

PRINT "Gewandelter Text!" 

PRINT st$ 

RETURN 

Zunächst wird also die Binärdatei CODE in die Zeichenkette GrossCode$ geladen. 
Dies kann auf unterschiedliche Weise geschehen. Hier wurde eine Direktzugriffs¬ 
datei mit einem einzelnen Satz verwendet, in dem der gesamte Binärcode von 55 
Bytes enthalten ist. 

Der langen Ganzzahlvariablen Wandle& wird die Startadresse der binären Zei¬ 
chenkette zugewiesen, die das Maschinensprache-Unterprogramm enthält. Ami¬ 
ga Basic weist dann eine temporäre Variable desselben Namens zu. 
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An das Maschinensprache-Unterprogramm werden zwei Argumente, nämlich 
adr&, die Adresse der zu umzucodierenden Zeichenkette sowie laeng&, deren 
Länge, übergeben. Sie werden im Anschluß an den Namen des Unterprogramms 
in Klammern angegeben. Dadurch werden sie beim Aufruf des Unterprogramms 
auf dem Stapel abgelegt (zuerst adr&, dann laeng&), von dem sie das Unterpro¬ 
gramm entnimmt. 

Das Unterprogramm prüft alle Zeichen auf Kleinbuchstabe. Ist eines gefunden, so 
wird es durch den entsprechenden Großbuchstaben ersetzt. Alle anderen Zei¬ 
chen werden nicht verändert. Am Ende der umzucodierenden Zeichenkette wird 
die Programmsteuerung wieder Amiga Basic übergeben. Im Basic-Programm 
wird schließlich die umcodierte Zeichenkette ausgegeben. 


6.3 Aufruf von Bibliotheksroutinen 

Bibliotheksroutinen sind spezielle Amiga-Programmdateien, die während der 
Laufzeit dynamisch mit Amiga Basic zusammengebunden werden. Um eine 
Bibliotheksroutine aufzurufen, wird die CALL-Anweisung in ähnlicher Weise 
verwendet wie zum Aufruf von selbstprogrammierten Maschinensprache-Routi¬ 
nen. Auch hier werden die Parameter mit ihrem Wert entsprechend den Aufrufkon¬ 
ventionen der Programmiersprache C übergeben. Um auf eine Bibliotheksroutine 
zugreifen zu können, müssen Sie zuerst die entsprechende Bibliothek öffnen. 

Im folgenden wird ein Teil des Bibliotheksprogrammes, das auf der Extras-Disket¬ 
te vorhanden ist, schrittweise beschrieben. 


Eine Bibliothek öffnen 

Für Ihre Amiga Basic-Anwendungen existieren eine ganze Reihe von Biblio¬ 
theken, von denen jede wiederum mehrere spezielle Routinen anthält. Jeder 
dieser Routinen ist eine besondere Informationsdatei zugeordnet, in der die 
erforderlichen Parameter und die zu verwendenen Prozessor-Register aufge¬ 
führt sind. Diese speziellen Dateien werden als .fd-Dateien bezeichnet. 

Amiga Basic verwendet die Informationen in den fd.-Dateien etwas anders als 
der MC68000-Assembler oder der C-Compiler. Deshalb muß jede .fd-Datei in 
eine .bmap-Datei konvertiert werden, ehe eine Routine aus der Bibliothek von 
Amiga Basic aus verwendet werden kann. Das Hilfsprogramm ConvertFD für 
diese Konvertierung befindet sich in der BasicDemos-Schublade (-Unterver¬ 
zeichnis) auf der Extras-Diskette. 
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Die Extras-Diskette enthält allerdings nur die .bmap-Dateien für die dos.libra- 
ry- und die graphics.library-Routinen. Wenn Ihre Anwendung Zugriff auf eine 
der intuition.Iibrary-Routinen erfordert, müssen Sie die .fd-Dateien für die 
Bibliothek intuition.library mit dem Hilfsprogramm ConvertFD in .bmap-Da- 
teien konvertieren. 

Im Anhang F finden Sie Details über das Format der .bmap-Dateien. 

Sie öffnen eine Bibliothek mit der LIBRARY-Anweisung (s. dort in Kapitel 9). 
Unter der Voraussetzung, daß die eingelegte Diskette die entsprechenden 
.bmap-Dateien enthält, werden durch diese Anweisung alle die zur angespro¬ 
chenen Bibliothek gehörenden Routinen für Ihr Amiga Basic-Programm 
verfügbar gemacht. Zur gleichen Zeit können bis zu fünf Bibliotheken geöffnet 
sein. 


Eine Funktion aufrufen 

Ist die Bibliothek erst einmal geöffnet, kann auf deren Routinen in ähnlicher 
Weise wie auf selbstgeschriebene Maschinensprache-Unterprogramme zu¬ 
gegriffen werden. Wenn von der aufgerufenen Routine jedoch ein Wert 
zurückerwartet wird, muß im Amiga Basic-Programm dessen Typ mit einer 
DECLARE FUNCTION-Anweisung (s. dort in Kapitel 9) festgelegt werden 
(z.B. durch das Zeichen & am Ende des Variablennamens bei einem langen 
Gleitpunkt-Wert). 

Der folgende Teil des Bibliotheks-Demonstrationsprogrammes zeigt die 
Anwendung dieser Anweisungen: 

DECLARE FUNCTION RsIlSafiSiyle« LIBRARY 
DECLARE FUNCTION OpenFont« LIBRARY 
LIBRARY "graph ics.1ibrary" 
enabIe^-flskSoftStyIea(WINDOW(8)) 

Font "topaz . f ont" ,8,0*0 
FOP i = 0 TO 4 

SetStyle CI NTC2ti> 

NEXT i 


SUB SetStyle(rrtaskY) STATIC 
SHARED enahleX 

SetSof tStyle UINDOW(8),mask^, enable% 
PRINT "SetSoftStyIe C”;maskX;"3” 

END SUB 
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Mit den DECLARE FUNCTION-Anweisungen wird Amiga Basic mitgeteilt, daß 
die beiden Funktionen AskSoftStyle& und OpenFont& aus der Bibliothek 
graphics.library Ganzzahlwerte liefern. Die Bibliothek selbst wird mit der 
LIBRARY-Anweisung in der dritten Programmzeile geöffnet. 

Mit der darauf folgenden Anweisung wird die Routine bei AskSoftStyle& 
aufgerufen und deren zurückgegebener Wert der Variablen enable°/o zugewie¬ 
sen. Beachten Sie hier, daß das Schlüsselwort CALL nicht erforderlich ist. 
Ausnahmen werden unten beschrieben. Wenn der Aufruf ausgeführt wird, 
richtet Amiga Basic eine temporäre Variable mit demselben Namen AskSoft- 
Style ein (die Kennung & wird dabei ignoriert). 

Bei diesem Beispiel wird der zurückgegebene Wert zu einer kurzen Ganzzahl 
abgeschnitten. Er repräsentiert die acht Schriftarten-Bits des aktuellen Zei¬ 
chensatzes. Die DECLARE FUNCTION-Anweisung könnte deshalb ebenso¬ 
gut eine kurze Ganzzahl-Variable verwenden: 

DECLARE FUNCTION RskSoftStyleX LIBRARY 

Ohne jede Deklaration würde Amiga Basic allerdings versuchen, eine Zuwei¬ 
sung in einfacher Genauigkeit auszuführen und das Ergebnis wäre falsch. 

Die Funktion AskSoftStyle& benötig einen Parameter, nämlich die WINDOW- 
Funktion (s. dort in Kapitel 9), mit deren Hilfe Informationen über den aktuellen 
Zeichensatz gewonnen werden kann. 

In dem Beispiel werden noch verschiedene andere Routinen aus der Biblio¬ 
thek graphics.library verwendet, wobei für jede die Parameter, die von Amiga 
Basic übergeben werden, aufgelistet sind. Jede dieser Bibliotheksroutinen ist 
in dem AmigaROM-Handbuch beschrieben. 


Explizite Verwendung des CALL-Schlüsselwortes 

Die meisten Bibliotheksroutinen können, wie in dem o.a. Beispiel angegeben, 
ohne das Schlüsselwort CALL aufgerufen werden. Wenn jedoch der Aufruf auf 
eine ELSE- oder THEN-Klausel folgt, muß CALL angegeben werden, damit 
der Interpreter den Routinennamen nicht mit einer Sprungmarke verwechselt. 
Also z.B.: 


I F pFontAOB THEN CALL CloseFont (pFont*) 
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6.4 Verarbeitung von Unterbrechungsereignissen 


Die Unterbrechungsreaktion ist ein Hilfsmittel, mit dem ein Programm auf be¬ 
stimmte Ereignisse reagieren und zu einem entsprechenden Programmteil ver¬ 
zweigen kann. Amiga Basic kann auf folgende Ereignisse reagieren: 

• Zeitablauf (ON TIMER-Anweisung), 

• Programmabbruch durch Anwender (ON BREAK-Anweisung), 

• Die Wahl eines Menü-Punktes (ON MENU-Anweisung), 

• Maus-Aktivität (ON MOUSE-Anweisung). 

Bei aktivierter Unterbrechungsreaktionsfähigkeit prüft Amiga Basic vor der Aus¬ 
führung einer jeden Anweisung, ob ein spezifiziertes Ereignis eingetreten ist. 

In der Praxis erstellt der Programmierer eine Subroutine, um auf das Ereignis zu 
reagieren und aktiviert die Unterbrechungsreaktionsfähigkeit. Sobald dann das 
betreffende Ereignis eintritt, wird die Programmsteuerung automatisch an die 
Subroutine übergeben. Intern entspricht dies exakt einer GOSUB-Anweisung zu 
dieser Subroutine. 

Als Abschluß der Subroutine wird durch eine RETURN-Anweisung die Programm¬ 
steuerung wieder an die Anweisung im Hauptprogramm zurückgegeben, die der 
letzten vor der Unterbrechung noch ausgeführten Anweisung folgt. 

In diesem Abschnitt wird ein Überblick über die Programmiertechnik für Unterbre¬ 
chungsreaktionen gegeben. Nähere Informationen über die oben erwähnten 
Anweisungen entnehmen Sie bitte den entsprechenden Abschnitten im Kapitel 9. 

Die Unterbrechungsreaktionsfähigkeit wird durch folgende Anweisungen ge¬ 
steuert: 


Ereignis ON 
Ereignis OFF 
Ereignis STOP 


schaltet Reaktionsfähigkeit ein, 
schaltet Reaktionsfähigkeit aus, 
schaltet Reaktionsfähigkeit vorübergehend aus. 
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Für Ereignis muß eines der folgenden Schlüsselwörter angegeben werden. 

TIMER Damit ist die Systemuhr des Amiga gemeint. Mit ihr kann der 

Ablauf einer vorgegebenen Anzahl von Sekunden überwacht 
werden. 

MOUSE Die Programmsteuerung kann vom Drücken einer der Aus¬ 

wahltaste der Maus abhängig gemacht werden. 

MENU Die Programmsteuerung kann von der Wahl eines Menüs aus 

der Menü-Leiste abhängig gemacht werden. 

BREAK Sobald der Anwender die Tastenkombination rechte Amiga- 

Taste - Punkt-Taste drückt, verzweigt das Programm zur 
angegebenen Subroutine. Diese Reaktionsmöglichkeit sollte 
jedoch mit Vorsicht verwendet werden. Wenn sie in einem zu 
testenden Programm verwendet wird, kann das Programm vor 
der END-Anweisung nicht anders als durch Rücksetzen des 
gesamten Systems beendet werden. Deshalb sollte zunächst 
die BREAK ON-Anweisung weggelassen werden und erst 
eingefügt werden, wenn das Programm vollständig ausgete¬ 
stet ist. 

COLLISION Die Programmsteuerung wird von der Kollision eines mit der 

OBJECT.SHAPE-Anweisung (s. dort in Kapitel 9) erzeugten 
beweglichen, grafischen Objektes (Sprite oder Bob (s. Kapitel 
7.4)) mit einem anderen Objekt oder dem Bildfensterrand 
abhängig gemacht. 


ON.. .GOSUB-Anweisung 

Mit dieser Anweisung wird die Anfangszeile der Verarbeitungs-Subroutine für 
das Unterbrechungsereignis festgelegt. Das Format ist 


OH Ereignis GOSUB Sprungmarke 


Wird für Sprungmarke eine 0 angegeben, so wird die Unterbrechungsreakti¬ 
onsfähigkeit inaktiviert. 

Aktivierung der Unterbechungsreaktionsfähigkeit Wenn die Unterbre¬ 
chungsreaktionsfähigkeit für ein Ereignis aktiviert ist (ON) und eine von 0 
verschiedene Sprungmarke in der ON. . .GOSUB-Anweisung angegeben 




Besonderheiten von Amiga Basic 


6-17 


wurde, prüft der Amiga Baisc-Interpreter vor der Ausführung jeder Anwei¬ 
sung, ob das angegebene Ereignis eingetreten ist. 

Solange die entsprechende Ereignis ON-Anweisung nicht gegeben wurde, 
findet jedoch keine Reaktion durch die entsprechnede ON Ereignis GOSUB- 
Anweisung statt. 

Inaktivierung der Unterbrechungsreaktionsfähigkeit Wenn die Unterbre¬ 
chungsreaktionsfähigkeit für ein Ereignis abgeschaltet ist (OFF), erfolgt keine 
Unterbrechung, und der Eintritt des Ereignisses wird auch nicht gespeichert. 

Unterbrechungsreaktionsfähigkeit zeitweilig inaktivieren Wenn die Unter¬ 
brechungsreaktionsfähigkeit für ein Ereignis nur gestoppt ist (STOP), nicht 
aber abgeschaltet, erfolgt beim Eintritt des Ereignisses ebenfalls keine 
Unterbrechung, der Eintritt wird aber gespeichert. Sobald jetzt eine Ereignis 
ON-Anweisung gegeben wird, erfolgt sofort eine Unterbrechung. 

Sobald eine Unterbrechungsreaktion stattgefunden hat, führt der Interpreter 
intern automatisch für das betreffende Ereignis eine Ereignis STOP-Anwei- 
sung durch, um Unterbrechungsschachtelung zu verhindern. Nach Rückkehr 
aus der Bearbeitungsroutine wird automatisch eine Ereignis ON-Anweisung 
ausgeführt, um die Unterbrechungsreaktionsfähigkeit für das entsprechende 
Ereignis wieder zu aktivieren, es sei denn, in der Unterbrechungsroutine 
selbst wurde explizit eine Ereignis OFF-Anweisung für das betreffende 
Ereignis gegeben. 

Achtung: Hat eine Unterbrechungsreaktion stattgefunden, so bleibt die 
Reaktionsfähigkeit für dieses Ereignis solange abgeschaltet, bis eine RESU- 
ME-Anweisung (s. dort in Kapitel 9) ausgeführt wurde. 


6.5 Speicherverwaltung 

Mit Hilfe der CLEAR-Anweisung können Sie bei großen Programmen den Spei¬ 
cher für verschiedene Zwecke aufteilen. 

Sie können die Größe von drei verschiedenen Speicherbereichen mit der 
CLEAR-Anweisung einstellen: 

• den Stapel-Speicher; 

• den Amiga Basic-Programmspeicher; 

• den Amiga Basic-Systemspeicher. 
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Der Stapelspeicher 

Der Stapelspeicher dient dem Amiga Basic-Interpreter zum Vermerken von 
Rückkehradressen bei Subroutinen- oder Unterprogrammaufrufen sowie zur 
Buchführung bei geschachtelten Schleifen oder Anwenderfunktionen. 

Verringerung des Stapelspeicherplatzbedarfs Einige spezielle ROM-Routi- 
nen des Amiga haben, wenn aufgerufen, erheblichen Stapelspeicherbedarf. 
Außerdem steigt der Bedarf an Stapelspeicher, wenn ein Programm viele 
geschachtelte Schleifen enthält. Durch geschickte Programmiertechnik kann 
erheblich an Stapelspeicher gespart werden. 


Der Amiga Basic-Programmspeicher 

Im Programmspeicher ist der eigentliche Programmtext, also die einzelnen 
Programmzeilen, abgelegt. Ferner sind hier die Variablen des Programms 
sowie Zeichenketten gespeichert. Schließlich enthält der Programmspeicher 
die Datenpuffer für geöffnete Dateien. 

Verringerung des Programmspeicherplatzbedarfs Der Puffer für eine se¬ 
quentielle Datei ist mit 128 Bytes Länge voreingestellt. Durch Verkleinerung 
der Pufferlänge (s. OPEN-Anweisung in Kapitel 9) kann Speicher gespart 
werden. Dies geht jedoch auf Kosten der Verarbeitungsgeschwindigkeit. 
Einen weiteren Einfluß auf den Programmspeicherbedarf hat der Typ der 
verwendeten numerischen Variablen. Ganzzahlvariablen brauchen halb soviel 
Speicherplatz wie Variablen einfacher Genauigkeit, und diese halb soviel wie 
Variablen doppelter Genauigkeit. Außerdem benötigt die Verkettung mehrerer 
kleiner Programmsegmente mit der CHAIN-Anweisung (s. dort in Kapitel 9) 
weniger Speicher als ein großes Programm. 


Der System-Speicher 

Der Amiga Basic-Systemspeicher enthält die Puffer für die Informationen, die 
die SOUND- und WAVE-Anweisungen (s. dort in Kapitel 9) benötigen, wenn 
sie aufgerufen werden. In diesem Fall werden 1024 Bytes reserviert. Außer¬ 
dem benötigen die Anweisungen WINDOW, SCREEN und LIBRARY Teile des 
Systemspeichers. Amiga Basic teilt sich den Systemspeicher mit anderen 
Programmen, die ggf. gleichzeitig ablaufen (Multitasking). 
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Verringerung des Systemspeicherplatzbedarfs Sobald der SOUND-/ 
WAVE-Datenpuffer nicht mehr benötig wird, sollte er mit der ERASE-Anwei- 
sung wieder freigegeben werden. Dies verringert den Systemspeicherplatz¬ 
bedarf immerhin um 1 KByte. 


Speicherreservierung mit der CLEAR-Anweisung 

Mit der CLEAR-Anweisung können Sie, wie schon erwähnt, für drei Speich¬ 
erbreiche Platz reservieren. Die allgemeine Syntax der CLEAR-Anweisung ist 
folgende: 


CLEAR [ , [ Progrrammspa irhfirl [ , Sta pe icher] 1 

Das Argument Programmspeicher gibt an, wieviele Bytes für das eigentli¬ 
che Amiga Basic-Programm reserviert werden sollen. 

Das Argument Stapelspeicher gibt an, wieviel Bytes für den Amiga Basic- 
Stapelspeicher reserviert werden sollen. 

Der verbleibende Speicherrest, also die Differenz aus dem Gesamtspeicher 
sowie der Summe aus Programm- und Stapelspeicher wird automatisch für 
den Systemspeicher reserviert. Mit dem CLEAR-Befehl können Sie also 
vom Programm aus den für die drei einstellbaren Speicherbereiche benö¬ 
tigten Platz festlegen. Mit Hilfe der FRE-Funktion (s. dort in Kapitel 9) 
können Sie jederzeit feststellen, wieviel freien Speicher Sie noch in jedem 
der drei Bereiche zur Verfügung haben (s. unten) 
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Anwendung der FRE-Funktion bei der Speicherverwaltung 

Die FRE-Funktion hat folgende Syntax: 

FRE(n) 

mit drei verschiedenen Modi: 

1. Bei n =-1 liefert FRE die Anzahl der noch verfügbaren Systemspeicherby¬ 
tes. 

2. Bei n=- 2 liefert FRE die Anzahl der noch nicht benutzten Stapelspeicher¬ 
bytes 

3. Bei jeder anderen Zahl für n erhält man die Anzahl der noch verfügbaren 
Programmspeicherbytes. 

Bei jedem Aufruf von FRE wird außerdem der Zeichenkettenspeicherbereich 
innerhalb des Programmspeichers “aufgeräumt“ und komprimiert. 



Erzeugen bewegter Bilder 


7-1 


7. Erzeugen bewegter Bilder mit dem 
Objekt-Editor 


Dieses Kapitel beschreibt den Objekt-Editor. Der Objekt-Editor ist ein Hilfspro¬ 
gramm des Amiga Basic-Interpreters, mit dessen Hilfe grafische Objekte für 
Animations-Programme erzeugt werden können. Unter Animation versteht man 
die programmierte Bewegung von Abbildungen auf dem Bildschirm. Die Arbeits¬ 
weise des Objekt-Editors wird anhand eines schrittweise dargestellten Beispiels 
beschrieben. 


7.1 Übersicht 


Amiga Basic erschließt sich die Animationsmöglichkeiten des Amiga-Systems 
über Programm-Anweisungen und den Objekt-Editor. Die COLLISION- und 
OBJECT-Anweisungen (s. dort in Kapitel 9) manipulieren die grafischen Objekte 
im Ausgabe-Fenster. Mit Hilfe des Objekt-Editors werden diese Objekte, wie sie 
im weiteren Verlauf dieses Kapitels bezeichnet werden, definiert. 

Mit dem Objekt-Editor können Sie: 

• schnell Ovale, Rechtecke und Linien zeichnen, indem Sie den Maus-Zeiger, 
der hier die Funktion eines Zeichenstiftes hat, zwischen zwei Punkten auf der 
Zeichenfläche des Objekt-Editors bewegen. Die Zeichenfläche ist der Bereich 
des Ausgabe-Fensters, innerhalb dem Sie das Objekt entwerfen. 

• frei auf der gesamten Zeichenfläche mit dem Zeichenstift des Objek-Editors 
zeichnen. 

• Farben für die Umrandung des Objektes auswählen. 

• das Innere des Objektes mit der gewählten Randfarbe ausmalen. 

• beliebig in den Objekten löschen und ändern. 

Nach der Erzeugung eines Objektes kann dieses in einer Datei mit wählbarem 
Namen gespeichert werden. Die Datei enthält dann die statischen Attribute für das 
Objekt, also Form, Größe und Farbe. Um einem solchen Objekt in einem 
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Programm Bewegung zu verleihen, wird die Objektdatei zunächst geöffnet, das 
Objekt wird als binäre Zeichenkette eingelesen und dann mit der OBJECT.SHA- 
PE-Anweisung (s. dort in Kapitel 9) für das Programm definiert. 

Achtung: Der Objekt-Editor weist den erzeugten Objekten Attribute zu, die die 
Berührung von Objekten untereinander oder von Objekten mit dem Fensterrand 
als Kollision auslegen. Diese Voreinstellung kann mit der OBJECT.HIT-Anweisung 
(s. dort in Kapitel 9) geändert werden, so daß sich Objekte z.B. auch durchdringen 
oder hintereinander vorbeibewegen können. 


7.2 Das Fenster des Objekt-Editors 


In diesem Abschnitt wird die Darstellung des Objekt-Editor-Fensters (s.u.) 
innerhalb des Bildschirmes beschrieben. Innerhalb dieses Fenster entwerfen Sie 
Ihre Objekte: 



Das Fenster besteht aus einer Beihe von Elementen, die im folgenden näher 
erläutert werden: 
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Die Menü-Leiste 

Im Fenster des Objekt-Editors können Sie zwischen folgenden Menüs 
wählen: 

• File (Datei) 

• Tools (Hilfsmittel) 

• Enlarge (Vergrößern) 

Das File-Menü enthält Funktionen zum Laden oder Speichern von Objekten 
von bzw. auf Diskette. Die Funktionen des Tools-Menü erleichtern das 
Entwerfen von Objekten. Mit den Funktionen des Enlarge-Menüs können Sie 
Ihre Objekte vergößert darstellen, um feine Details anzubringen oder zu 
ändern. 


Die Zeichenfläche 

Die Zeichenfläche befindet sich oben links im Fenster des Objekt-Editors. 
Innerhalb dieser Fläche zeichnen oder verändern Sie Ihr Objekt und können es 
bunt ausmalen. 

Sie können die Größe der Zeichenfläche ganz einfach ändern, indem Sie das 
Größen-Symbol in der rechten unteren Fensterrahmen-Ecke mit gedrückter 
Auswahltaste der Maus ziehen. 

Wenn Sie ein Sprite erzeugen (ein Sprite ist ein besonderer Typ von Objekt, 
der im weiteren Verlauf dieses Kapitels noch näher beschrieben wird), können 
Sie dessen Breite nicht über die angezeigte Breite hinaus (16 Bildpunkte, von 
0 bis 15 gezählt), wohl aber dessen Höhe vergrößern. 


Die Farbauswahl-Leiste 

Mit Hilfe der Farbauswahl-Leiste links unten im Fenster der Objekt-Editors 
können Sie die Innen- und die Randfarben Ihres Objektes wählen oder 
verändern. Sie brauchen dazu nur auf die gewünschte Farbe zu zeigen und die 
Auswahltaste der Maus zu drücken. Das Wort Color (Farbe) links neben der 
Farbleiste wird dann in der gewählten Farbe angezeigt. 
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Die Anzahl der wählbaren Farben in der Farbauswahl-Leiste hängt von der 
Tiefe des Bildschirms ab, die mit der SCREEN-Anweisung (s. dort in Kapitel 9) 
eingestellt werden kann. 

Um Objekte mit mehr als vier Farben zu erzeugen, müssen Sie das Objekt- 
Editor-Programm ändern. Dieses Programm ist in Amiga Basic geschrieben 
und ausführlich mit Kommentaren in der Programmliste versehen, so daß 
Änderungen für einen geübten Programmierer nicht schwierig sind. Das 
Programm, mit dem vielfarbige Objekte bewegt werden sollen, muß eine 
SCREEN-Anweisung mit entsprechender Bildschirm-Tiefeneinstellung ent¬ 
halten. 


Die Status-Zeile 

in der unteren linken Ecke des Objekt-Editor-Fensters sehen Sie die x- und 
y-Koordinaten der Position innerhalb der Zeichenfläche, bei der die Auswahl¬ 
taste der Maus das letzte Mal gedrückt wurde. Rechts daneben wird die 
aktuelle, zuletzt aus dem Tools-Menü gewählte Funktion (Pen = Zeichenstift, 
Oval = Oval, Rectangle = Rechteck, Paint = Ausmalen, Eraser = Löscher) an¬ 
gezeigt. 


7.3 Die Menüs des Objekt-Editors 


Sie können zwischen folgenden Punkten des File-Menüs wählen: 

New Löscht den Bildschirm und zeigt die Zeichenfläche in ihren 

voreingestellten Abmaßen. 

Open Fordert die Eingabe eines existierenden Namens für eine Datei, 

die vorher mit dem Objekt-Editor erstellt wurde. Die Eingabe 
wird durch Drücken der RETURN-Taste abgeschlossen. 

Save Speichert ein Objekt in einer Datei unter demselben Namen, 

unter dem diese geöffnet wurde. Falls Sie vorher die New- 
Funktion benutzt haben, müssen Sie einen Dateinamen einge¬ 
ben. Die Eingabe wird in jedem Fall durch Drücken der 
RETURN-Taste abgeschlossen. 
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Save As Fordert zur Speicherung eines Objektes den Dateinamen an. 

Drücken der RETURN-Taste beendet die Eingabe. 

Quit Beendet die Arbeit mit dem Objekt-Editor und bringt Sie 

zurück auf die Amiga Basic-Ebene. 

Sie können zwischen folgenden Punkten des Tools-Menüs wählen: 

Pen Erlaubt das freie Zeichnen innerhalb der Zeichenfläche. 

Line Zeichnet eine Gerade zwischen zwei Punkten. 

Oval Zeichnet ein Oval. 

Rectangle Zeichnet ein Rechteck. 

Erase Löscht ein Bild innerhalb der Zeichenfläche. 

Paint Malt die Innenfläche eines Objektes mit der aktuell gewählten 

Farbe aus. 

Sie können zwischen folgenden Punkten des Enlarge-Menüs wählen: 

4x4 Vergrößert die Zeichenfläche um den Faktor 4. Dabei darf die 

Zeichenfläche nicht größer als maximal 100 Bildpunkte horizon¬ 
tal mal 31 Bildpunkte vertikal sein. 

1x1 Zeigt die Zeichenfläche in ihrer ursprünglichen Größe an. 


7.4 Eine Bemerkung über “Bobs“ und “Sprites“ 


Beim Amiga wird zwischen zwei verschiedenen Typen von grafischen Objekten 
unterschieden. In der Terminologie des Amiga sind dies Bobs und Sprites. Dem 
Objekt-Editor müssen Sie vor der Erstellung oder Änderung eines Objekts 
mitteilen, ob es sich dabei um ein Bob oder ein Sprite handelt. Sie müssen deshalb 
vorher die Unterschiede zwischen beiden Objekt-Typen kennen. Ist dies bereits 
der Fall, so können Sie jetzt gleich zum nächsten Kapitel dieses Handbuches 
weitergehen. 
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In der nachfolgenden Tabelle werden die wesentlichen Unterschiede zwischen 
Bobs und Sprites einander gegenübergestellt: 


Bobs 

lassen sich langsamer als 
Sprites bewegen. 

die Größe wird nur durch 
den verfügbaren Speicher 
begrenzt. 

Es sind alle Farben erlaubt. 


Sprites 

lassen sich schneller als 
Bobs bewegen. 

Die Breite ist auf 16 
Bildpunkte begrenzt. 

Es sind 3 Farben erlaubt. 


Es können alle Bobs ange- Auf einer Zeile können zur selben Zeit 

zeigt werden. nur vier Sprites mit verschiedenen Farben 

angezeigt werden. 


Wenn Sie sich näher mit Bobs und Sprites beschäftigen wollen, finden Sie im 
AmigaROM-Benutzerhandbuch eine Fülle von weiteren Informationen. 


7.5 Wie man Objekte erstellt 

Den Objekt-Editor finden Sie auf der Extras-Diskette in der Ablage BasicDemos 
unter dem Namen ObjEdit. Der Objekt-Editor wird wie jedes andere Amiga 
Basic-Programm aktiviert (s.a. Kapitel 2). 

Achtung: Wenn Sie mit einer 256-kBytes-Maschine arbeiten, müssen Sie das 
Piktogramm des Objekt-Editors aus dem Fenster der BasicDemos herausziehen. 
Anschließend schließen Sie alle Fenster und wählen dann das Objekt-Editor-Pik- 
togramm. Wollen Sie den Objekt-Editor dagegen aus Amiga Basic heraus laden, 
verwenden Sie den Dateinamen basicdemos/objedit. Außerdem müssen Sie die 
Zeile mit der Anweisung 


LIBRARV"graphics.1ibrarary" 


in 


LIBRARY " :basicdemos/graphi cs. 1ibrary” 


ändern. 
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Für die Erstellung eines Objektes folgen Sie jetzt diesen Schritten: 

1. Sobald der Objekt-Editor aktiviert ist, erhalten Sie folgende Anzeige: 

Enter 1 i f you want to edit sprites 
Enter* 0 if you. want to ed it bobs > 


(Geben Sie 1 ein, wenn sie Sprites erzeugen wollen 
Geben Sie 0 ein, wenn sie Bobs erzeugen wollen >) 

Geben Sie hier die gewünschte Kennung ein und drücken Sie die RETURN- 
Taste. 

Achtung: Versuchen Sie nicht, das Objekt-Editor-Fenster hinter andere 
Fenster, also in den Hintergrund, zu stellen. 

2. Jetzt wird das Objekt-Editor-Fenster angezeigt. Wählen Sie aus dem Files- 
Menü New, wenn Sie ein neues Objekt zeichnen wollen, oder Open, wenn Sie 
ein existierendes Objekt ändern wollen. 

3. Anschließend wählen Sie aus dem Tools-Menü, wie sie auf der Zeichenfläche 
arbeiten wollen. Wählen Sie die Pen wenn Sie frei zeichnen wollen, oder aber 
Line, Oval oder Rectangle, wenn Sie eine Gerade, ein Oval oder ein Rechteck 
zeichnen wollen. Mit Erase können Sie Teile des Objektes auch wieder 
löschen. 

Wenn Sie eine definierte Figur zwischen Punkten zeichnen wollen, brauchen 
Sie den Zeiger mit der Maus nur auf den Anfangspunkt zu stellen, die 
Auswahltaste der Maus niederzuhalten und dann die Maus zum Endpunkt zu 
bewegen. Anschließend geben Sie die Auswahltaste wieder frei. Der Zeichen¬ 
oder Löschvorgang wird außerdem automatisch beendet, sobald Sie mit dem 
Zeiger außerhalb der Zeichenfläche geraten und fortgesetzt, wenn Sie sich 
wieder innerhalb der Zeichenfläche befinden. 

Beachten Sie, daß, wenn Sie ein Oval zeichnen wollen, zunächst ein Rechteck 
auf der Zeichenfläche erscheint. Sobald Sie dann aber die Auswahltaste der 
Maus loslassen, wird dieses durch das Oval ersetzt. 

4. Für Farbänderungen zeigen Sie einfach mit dem Zeiger auf die entsprechende 
Farbe in der Farbauswahl-Leiste links unten im Fenster und drücken dann die 
Auswahltaste der Maus. Der Objekt-Editor umrahmt dann jedes neu erzeugte 
Objekt auf der Zeichenfläche mit dieser Farbe. 
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5. Zum Ausmalen des Inneren eines Objektes wählen Sie ebenfalls die ge¬ 
wünschte Farbe aus der Farbauswahl-Leiste und anschließend Paint aus dem 
Tools-Menü. Zeigen sie dann mit dem Zeiger auf den Bereich, den Sie 
ausmalen wollen und drücken Sie die Auswahltaste der Maus. 

Die auszumalende Fläche sollte vollständig von einer Umrandung in derselben 
Farbe umgeben sein. Andernfalls würde die Farbe in den umgebenden 
Bereich “auslaufen“. 

6. Zur Veränderung der Zeichenflächen-Größe brauchen Sie nur mit dem Zeiger 
auf das Größen-Symbol in der rechten unteren Ecke der Zeichenfläche zu 
zeigen, die Auswahltaste der Maus zu drücken und die Maus dann zu 
bewegen. 

Amiga Basic behandelt die Zeichenfläche unabhängig von der Anzahl der auf 
ihr erzeugten Einzelbilder generell als ein Objekt. Unterschiedliche Objekte 
müssen deshalb auch auf getrennten Zeichenflächen entworfen und in 
getrennten Dateien gespeichert werden. 

7. Ist das Objekt Ihren Vorstellungen entsprechend fertiggestellt, wählen Sie 
Save As aus dem File-Menü, wenn es sich um ein neues Objekt handelt, oder 
Save, wenn Sie ein bereits existierendes Objekt geändert haben, geben Sie 
ggf. den entsprechenden Dateinamen ein und drücken Sie abschließend die 
RETURN-Taste. 
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8. Die Elemente der Amiga Basic-Sprache 


8.1 Der Zeichensatz 

Der Amiga Basic-Zeichensatz besteht aus alphabetischen, numerischen und 
Sonderzeichen. Es gibt noch eine Reihe weiterer Zeichen, die alle angezeigt oder 
auch ausgedruckt werden können. Diese haben jedoch für Amiga Basic keine 
spezielle Bedeutung. 

Die alphabetischen Zeichen von Amiga Basic enthalten alle Buchstaben des 
englischen Alphabets. Die numerischen Zeichen sind die Ziffern 0 bis 9. Die 
Sonderzeichen sind zusammen mit ihrer Bedeutung in der folgenden Tabelle 
zusammengestellt: 

Zeichen Bedeutung 

Leerzeichen 

+ Plussymbol oder Verkettungssymbol für Zeichenketten 

Minussymbol oder Bindestrich 

* Multiplikationssymbol oder Stern 

/ Divisionssymbol oder Schrägstrich 

\ Symbol für Ganzzahldivision oder linker Schrägstrich 

f Potenzierungssymbol 

= Gleichheitszeichen oder Zuweisungssymbol 

< Kleiner-als-Symbol oder linke spitze Klammer 

> Größer-als-Symbol oder rechte spitze Klammer 

( linke Klammer 

) rechte Klammer 

j linke eckige Klammer 

] rechte eckige Klammer 

% Typsymbol für kurze Ganzzahl oder Prozentzeichen 

& Typsymbol für lange Ganzzahl oder kaufmännisches Und 

# Typsymbol für Zahlen doppelter Genauigkeit oder Nummern¬ 
zeichen 

$ Typsymbol für Zeichenketten oder Dollarzeichen 

! Typsymbol für Zahlen einfacher Genauigkeit oder Ausrufungs¬ 

zeichen 

Dezimalpunkt oder Punkt 
Komma 
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Zeichen Bedeutung 

Trennzeichen für Befehle oder Doppelpunkt 
; Zeilenvorschubunterdrückung oder Semikolon 

' Kommentareinleitung oder Apostroph 

“ Zeichenketten-Anfang bzw. -Ende oder Anführungszeichen 

? Abkürzung für PRINT-Anweisung oder Fragezeichen 

Unterstreichung 

@ At-Zeichen (“Klammeraffe“) 

RETURN Zeilenabschlußzeichen, Wagenrücklauf 

Alle diese Zeichen können auch als normale druckbare Zeichen Bestandteil von 
Zeichenketten sein. Weitere druckbare Zeichen sind in der vollständigen ASCII- 
Zeichencodetabelle im Anhang A zusammengestellt. 

Mit Hilfe der rechten Amiga-Taste können weitere Spezialzeichen eingegeben 
werden, die für Amiga Basic besondere Bedeutung haben: 


Tastenkombination 

Bedeutung 

Amiga-. (Punkt) 

Unterbricht ein Amiga Basic-Programm und kehrt auf 
Befehlsebene zurück. 

Amiga-S 

Hält ein Amiga Basic-Programm an. 

Amiga-T 

Führt die nächste Programmanweisung aus. 

Amiga-C 

Führt die Edierfunktion Copy (Kopiere) aus. 


Tastenkombination Bedeutung 


Amiga-P 

Amiga-X 

Amiga-R 

Amiga-L 


Führt die Edierfunktion Paste (Einfügen) aus. 

Führt die Edierfunktion Cut (Löschen) aus. 

Führt die Funktion Start aus dem Run-Menü aus. 
Führt die Funktion Show List (List-Fenster anzeigen) 
aus dem Windows-Menü aus. 
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8.2 Die Amiga Basic-Programmzeile 

Amiga Basic-Programmzeilen haben das folgende Format: 

[nnnnn] Anweisung [: Anweisung.. .][’ Kommentar] 
oder 

[Marke] Anweisung [-.Anweisung. . .[['Kommentar] 

nnnnn gibt die Zeilennummer an und muß eine ganze Zahl zwischen 0 und 65529 
sein. Wie Marke (s. unten) stellt die Zeilennummer eine Sprungmarke für Verzwei¬ 
gungsoperationen dar. Sie hat keinen Einfluß auf die Reihenfolge der Programm¬ 
zeilen. 

Marke, ist eine beliebige Kombination aus alphanumerischen, numerischen und 
Sonderzeichen bis zu einer Länge von 40 Zeichen, die mit einem Buchstaben 
anfangen und mit dem Doppelpunkt (:) beendet werden muß. Sie stellt eine 
Sprungmarke für Verzweigungsanweisungen dar. 

Anweisung ist ein beliebiger Amiga Basic-Befehl, eine -Anweisung, oder-Funkti¬ 
on. Mehrere von diesen in einer Zeile müssen durch Doppelpunkte (:) voneinander 
getrennt werden. 

Kommentar kann ein bliebiger Text zur Kommentierung der Progfammzeile sein. 
Er wird entweder eingeleitet durch ein Apostroph (') oder durch das Schlüsselwort 
REM mit vorangestelltem Doppelpunkt, also :REM (s.a. REM-Anweisung in 
Kapitel 9). 

Amiga Basic-Programmzeilen können also mit einer Zeilennummer, mit einer 
alphanumerischen Sprungmarke, mit beiden oder ohne beide beginnen. Sie 
müssen jedoch mit einem Wagenrücklaufcode (RETURN) beendet werden und 
dürfen höchstens 255 Zeichen lang sein. Weitere Programmzeilen werden in ein 
vorhandenes Programm eingefügt, indem der Cursor auf das Ende der vorherge¬ 
henden Zeile gesetzt und die RETURN-Taste gedrückt wird. Es wird dann eine 
Leerzeile eingefügt, an deren Anfang der Cursor gestellt wird. Der Wagenrücklauf¬ 
code ist der einzige unsichtbare Bestandteil einer Amiga Basic-Programmzeile. 

Zeilennummern und Sprungmarken dienen entweder zur Strukturierung eines 
Programmes, also dazu, es übersichtlicherzu machen, oder als Markierungen für 
die Programmsteuerung, also als Sprungziele für sämtliche Verzweigungsanwei¬ 
sungen (s. GOTO, GOSUB). 
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Wenn Sie z.B. einen besonderen Programmteil nur unter einer bestimmten 
Bedingung abarbeiten wollen, könnten Sie z.B. schreiben: 

IF BETRflG=0 THEN GOSUB STORNO 

Der Amiga Basic-Interpreter sucht dann nach einer Sprungmarke namens 
STORNO: und bearbeitet die damit beginnene Subroutine. Beachten Sie, daß der 
Doppelpunkt nur bei der Sprungmarke selbst stehen muß, nicht bei ihrer Verwen¬ 
dung in einer Verzweigungsanweisung. 

Achtung: Der Amiga Basic-Interpreter arbeitet die Zeilen in einem Programm in 
der Reihenfolge ab, in der sie eingegeben wurden und nicht in der Reihenfolge 
ggf. vergebener Zeilennummern. Dies ist ein wesentlicher Unterschied zu her¬ 
kömmlichen Basic-Dialekten! 


8.3 Definition von Sprungmarken 

Wie bereits erwähnt, dürfen alphanumerische Sprungmarken zwischen 1 und 40 
Zeichen lang sein, müssen mit einem Buchstaben beginnen und mit einem 
Doppelpunkt (:) enden, können sonst beliebige Zeichen enthalten und müssen auf 
jeden Fall am Anfang einer Zeile stehen. Ihre Verwendung macht neben der 
Programmsteuerung die Lesbarkeit von Progammen leichter. 


Folgende Beispiele für Zeilennummern und Sprungmarken sind gültig: 

Zeilennummern Sprungmarken 


100 

65529 

i 


HLPHfi: 

Beta : 

Sprang.Zie1 I 


Einschränkungen 

Der Doppelpunkt am Ende einer Sprungmarke ist deshalb erfoderlich, damit 
der Interpreter Sprungmarken und Variablennamen auseinanderhalten kann. 
Es darf deshalb auch keine Leerstelle zwischen Sprungmarke und Doppel¬ 
punkt stehen. Bei der Verwendung einer Sprungmarke in einer Verzweigungs¬ 
oder sonstigen Steueranweisung darf der Doppelpunkt jedoch nicht angege¬ 
ben werden. Es dürfen außerdem keine reservierten Amiga Basic-Wörter (s. 
Anhang C) für Sprungmarkennamen verwendet werden. 
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Während die Zahl 0 als Zeilennummer in einem Programm erlaubt ist, wird sie 
von den Unterbrechungsreaktionsanweisungen zum Abschalten der Reakti¬ 
onsfähigkeit verwendet: 

ON ERROR GOTO 0 

bedeutet deshalb nicht eine Verzweigung zur Zeile 0, sondern vielmehr, daß 
die Unterbrechungsreaktionsfähigkeit bei Programmfehlern abgeschaltet 
wird. 

Achtung: Amiga Basic verwendet Zeilennummern ausschließlich als Sprung¬ 
marken. Sie werden nicht sortiert und Doubletten sind möglich. 


Format 

Eine Sprungmarke, eine Zeilennummer oder beides kann in jeder beliebigen 
Programmzeile Vorkommen. Wird eine Zeilennummer angegeben, so muß sie 
in der äußerst linken Spalte beginnen. Eine Sprungmarke muß mit dem ersten 
von einer Leerstelle verschiedenen Zeichen, das auf die Zeilennummer (falls 
vorhanden) folgt, beginnen und muß mit einem Doppelpunkt enden. Zwischen 
Sprungmarke und Doppelpunkt darf kein Leerzeichen stehen. 

Sowohl alphanumerische Sprungmarken als auch Zeilennummern können im 
selben Programm Vorkommen. 


8.4 Konstanten 

Konstanten sind die aktuellen Werte, die Amiga Basic während der Programmaus¬ 
führung benutzt. Es gibt zwei Konstanten-Typen. 

• Zeichenkettenkonstanten 

• numerische Konstanten 

Eine Zeichenkettenkonstante ist eine Folge von bis zu 32767 alphanumerischen 
Zeichen, eingeschlossen in Anführungszeichen (“). Z.B.: 

"HHUS" 

"Hund und Katze" 

''DM 12.80" 
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Numerische Konstanten sind positive oder negative Zahlen. Amiga Basic unter¬ 
scheidet 6 Typen numerischer Konstanten: 

• kurze Ganzzahl Alle ganzen Zahlen zwischen -32768 und + 32767 ohne 

Dezimalpunkt. 

• lange Ganzzahl Alle ganzen Zahlen zwischen-2147483648 und 

+ 2147483647 ohne Dezimalpunkt. 

• Festpunktzahl Alle positiven oder negativen reellen Zahlen mit einem 

Dezimalpunkt. 

• Gleitpunktzahl Alle positiven oder negativen Zahlen in Exponentialdar- 

stellung (wissenschaftliche Darstellung). Sie bestehen 
aus einer ganzen oder einer Festpunktzahl (Mantisse) 
mit oder ohne Vorzeichen, gefolgt vom Buchstaben D 
(doppelte Genauigkeit) oder E (einfache Genauigkeit) 
und einer ganzen Zahl im Bereich zwischen -308 und 
+ 308 mit oder ohne Vorzeichen, die den Exponenten 
zu Basis 10 darstellt. 

• Hexadezimalzahl Alle Zahlen in hexadezimaler Darstellung. Sie dürfen bis 

zu vier Zeichen (Ziffern 0 bis 9; Buchstaben A bis F) 
enthalten, denen die Kennung &H vorangestellt ist. 

• Oktalzahl Alle Zahlen in oktaler Darstellung. Sie dürfen bis zu 6 

Ziffern im Bereich zwischen 0 und 7 enthalten, denen 
die Kennung &0 oder nur & vorangestellt ist. 

Fest- und Gleitpunktzahlen können mit einfacher oder doppelter Genauigkeit 
verarbeitet werden. Bei einfacher Genauigkeit werden diese Zahlen mit bis zu 7 
Stellen plus dem Exponenten gespeichert und mit bis zu 7 Stellen angezeigt oder 
ausgedruckt. Bei doppelter Genauigkeit werden diese Zahlen mit bis zu 16 Stellen 
plus dem Exponenten gespeichert und mit bis zu 16 Stellen angezeigt oder 
ausgedruckt. Im Anhang D wird die interne Darstellung von Zahlen bei Amiga 
Basic detailliert beschrieben. 
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Eine numerische Konstante einfacher Genauigkeit hat eine der folgenden Eigen¬ 
schaften: 

• 7 oder weniger Stellen 

• Exponentialdarstellung mit Exponentkennung E 

• Ein Ausrufungszeichen (!) am Ende 

Eine numerische Konstante doppelter Genauigkeit hat eine der folgenden Eigen¬ 
schaften: 

• 8 oder mehr Stellen 

• Exponentialdarstellung mit Exponentkennung D 

• Ein Nummernzeichen (#) am Ende 

Hier einige Beispiele für numerische Konstanten: 

1234 kurze Ganzzahl 

i5.iz Festpunktzahl 

-0.56 

2345678 lange Ganzzahlen 

-45789369 

15 E -3 Gleitpunktzahlen 

-1.24683D-4 

8 H 2 def Hexadezimalzahlen 

—«HFFFF 

«0177 Oktalzahlen 

-«336 

Numerische Konstanten in Amiga Basic dürfen keine Kommata enthalten. 
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8.5 Variablen 


Variablen sind Namen, die Werte repräsentieren, welche in einem Amiga Basic- 
Programm verwendet werden. Der Interpreter unterscheidet dabei zwischen 

• Zeichenketten-Variablen 

• numerischen Variablen 

Zeichenkettenvariablen dürfen aus bis zu 32767 Zeichenkettenwerten (einzelne 
Zeichen) bestehen. Die Anzahl dieser Werte bestimmt die Länge des Variablen¬ 
wertes. 

Numerische Variablen haben immer einen Wert, der aus einer Zahl besteht. 

Der Wert einer Variablen kann dieser explizit vom Programmierer oder, als 
Ergebnis von Programmoperationen, vom Programm zugewiesen werden. Wer¬ 
den Variablen benutzt, ehe ihnen ein Wert zugewiesen wurde, ist ihr Wert 0 im Fall 
von numerischen Variablen und eine leere Zeichenkette der Länge 0 (Leerstring) 
im Fall von Zeichenkettenvariablen. 


Varlabiennamen und -Typen 

Amiga Basic akzeptiert beliebig lange Variablennamen, interpretiert jedoch 
nur die ersten 40 Zeichen sowie ggf. das letzte, das den Variablentyp definiert 
(s. unten) und eines der Sonderzeichen $ % & ! # sein muß, wenn ein anderer 
Typ als numerisch mit einfacher Genauigkeit definiert werden soll. 

Ein Variablenname muß als erstes Zeichen einen Buchstaben haben und darf 
aus Buchstaben, Ziffern und dem Dezimalpunkt in jeder beliebigen Kombinati¬ 
on bestehen. Kleinbuchstaben werden intern als Großbuchstaben interpre¬ 
tiert. Er darf nicht ein reserviertes Amiga Basic-Wort (s. Anhang C) sein; wohl 
aber darf ein reserviertes Wort Bestandteil des Namens sein: Z.B.: 

sin= 101 verboten (SIN-Funktion) 

si nput= 101 erlaubt (SIN nur Teil des Namens) 

Eine Ausnahme bilden Namen, die mit FN beginnen. Der Teil nach FN würde 
nämlich von Amiga Basic als benutzerdefinierte Funktion interpretiert (s. DEF 
FN-Anweisung in Kapitel 9). 
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Der Name einer Variablen dient nicht nur ihrer Benennung, sondern auch der 
Definition ihres Typs und, falls numerisch, ihrer Genauigkeit. 

Zeichenkettenvariablen werden durch ein $ als letztem Zeichen im Namen 
definiert. Z.B.: 

C$="COMMODORE fHilGO" 

Numerische Ganzzahlvariablen werden durch ein % oder & als letztem 
Zeichen im Namen definiert, je nachdem, ob es eine kurze oder lange 
Ganzzahlvariable ist. Z.B.: 

T8G*:=30: GEWINN«=456789258 

Numerische Variablen einfacher Genauigkeit haben kein Sonderzeichen 
oder ein ! am Namensende. Z.B.: 

ZINS=15.84 

ZINS!=1S.84 

Numerische Variablen doppelter Genauigkeit werden durch ein # als 
letztem Zeichen im Namen definiert. Z.B.: 


EFG#=45.789678524 


Je größer die geforderte Genauigkeit ist, umso mehr Speicher und Programm 
laufzeit werden benötigt. Der Platzbedarf ist bei: 


kurzen Ganzzahlvariablen 
langen Ganzzahlvariablen 
Variablen einfacher Genauigkeit 
Variablen doppelter Genauigkeit 
Zeichenkettenvariablen 


2 Bytes 
4 Bytes 

4 Bytes (7 Stellen) 

8 Bytes (16 Stellen) 

5 Bytes plus Länge der Zeichenkette 


Eine globale Variablen-Typdefinition kann durch die Anweisungen DEFINT, 
DEFLNG, DEFSNG, DEFDBL und DEFSTR (s. Kapitel 9) in einem Programm 
vorgenommen werden. 
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Feldvariablen 

Ein Feld ist eine Gruppe oder Tabelle von numerischen oder Zeichenketten¬ 
werten, die durch einen Variablennamen repräsentiert wird. Jeder dieser 
Werte wird als Feldelement bezeichnet und mit einem Index zum Variablenna¬ 
men beschrieben. Dieser Index ist einen ganze Zahl oder ein ganzzahliger 
Ausdruck. Einem Feldvariablennamen sind genausoviele Indizes zugeordnet, 
wie das Feld Dimensionen hat. Die Dimensionierung eines Feldes, mit der 
gleichzeitig auch die Benennung verbunden ist, erfolgt mit der Anweisung DIM 
(s. dort in Kapitel 9). Z.B.: 

dim xc25) Ein eindimensionales Feld X mit 26 Elementen (0 bis 

25) einfacher Genauigkeit wird dimensioniert. 

dim 2 , 6 ) Ein zweidimensionales Zeichenkettenfeld mit 21 Ele¬ 

menten (3*7) wird dimensioniert. 

Mit der Dimensionierung werden alle Feldelemente des dimensionierten 
Feldes auf Null gesetzt. 

Der Index bestimmt die Position eines Elementes im Feld. 

Die maximale Anzahl von Elementen in jeder Dimension ist 32767 und es sind 
maximal 255 Dimensionen möglich. 

Bei zweidimensionalen Feldern gibt der erste Index grundsätzlich die Zeile 
und der zweite Index die Spalte der durch ein solches Feld gebildeten Tabelle 
an. 

Eindimensionale Felder mit bis zu 11 Elementen brauchen nicht dimensioniert 
zu werden. Wird in einem Programm z.B. die Anweisung 

FIC6J=1Z.3 

verwendet, ohne daß vorher A dimensioniert wurde, so führt der Interpreter 
intern die Anweisung 

DIM (U 10) 

aus und dimensioniert damit das Feld selbst. 

Für die Namensvergabe, Genauigkeit und den Typ gelten dieselben Regeln 
wie für einfache Variablen (s. oben). 
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Wandlung von einer Genauigkeit in eine andere 

Bei der Zuordnung von Werten zu Variablen einer anderen Genauigkeit sind 
einige Regeln zu beachten, nach denen der Interpreter dabei verfährt. Im 
einzelnen sind dies: 

1. Wird ein numerischer Wert einer Variablen mit anderer Genauigkeit 
zugeordnet, so wird der Wert in der Genauigkeit der Variablen gespeichert 
und dabei ggf. gerundet. Z.B.: 

Xa;= 12.5: PRI NT XX 
13 
Ok 

2. Wird ein Wert höherer Genauigkeit einer Variablen niedrigerer Genauigkeit 
zugeordnet, so wird er gerundet. Z.B.: 

fl=12.75455835«:PRINT fi 
12.75456 
Ok 

Dies ist insbesondere dann zu beachten, wenn gebrochene Werte ange¬ 
geben werden, wo ganzzahlige gefordert sind. Z.B.: 

TfiB<8.5) ergibt tobc9 > 
bc3 .6) ergibt b(4j 

3. Wird ein Wert niedrigerer Genauigkeit einer Variablen höherer Genauigkeit 
zugeordnet, so kann er danach nicht genauer sein als vorher. Der Fehler, 
der dabei entsteht, liegt etwa bei 6.3E-8. Z.B.: 

0=1. 65: B#=ft: PRINT ft; B« 

1.65 1.649999976158142 
Ok 

4. Die Berechnung arithmetischer Ausdrücke erfolgt immer in der Genauig¬ 
keit des genauesten Operanden. In dieser Genauigkeit wird auch das 
Ergebnis geliefert. Z.B.: 

PRINT 5U/3 
. 555555S5SS555556 
Ok 

fi=5#--'9:PRINT ft 
. 5555556 
Ok 
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Im letzten Beispiel wird das doppeltgenaue Ergebnis der einfachgenauen 
Variablen A zugeordnet und damit gerundet (s. Regel 2). 

5. Logische Operatoren (s. Kapitel 8.6) wandeln ihre Operanden grundsätz¬ 
lich in ganzzahlige Werte um und liefern auch ganzzahlige Ergebnisse. Die 
Operanden müssen deshalb auch im Bereich zwischen-32768 und 32767 
liegen. 


8.6 Numerische Ausdrücke und Operatoren 


Ein numerischer Ausdruck kann eine numerische Konstante oder Variable oder 
eine Kombination aus numerischen Konstanten, Variablen und Operatoren zur 
Berechnung eines einzelnen Wertes sein. Die Operatoren führen dabei mit den 
Werten mathematische oder logische Operationen durch. Amiga Basic kennt vier 
verschiedene Kategorien von Operatoren: 

• arithmetische Operatoren 

• Vergleichsoperatoren 

• logische Operatoren 

• Funktionsoperatoren 


Mathematische Hierarchie 

Bei der Bearbeitung numerischer Ausdrücke und Operatoren hält Amiga 
Basic folgende mathematische Hierarchie ein (1 höchste, 12 niedrigste 
Priorität): 

1. Funktionsaufrufe 

2. Potenzierung (|) 

3. Negation (Wandlung von Plus nach Minus u. umgekehrt) 

4. Multiplikation und Division (*, /) 

5. Ganzzahldivision (\) 

6 . Modulo-Arithmetik (MOD) 

7. Addition und Subtraktion (+, -) 

8 . logisches Komplement (NOT) 

9. Konjunktion (AND) 
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10. Disjunktion (OR) 

11. exklusives ODER (XOR) 

12. Äquivalenz (EQV) 

13. Implikation (IMP) 

Aufeinanderfolgende Operatoren derselben Hierarchiestufe werden von links 
nach rechts abgearbeitet. Die Hierarchie kann durch Verwendung von Klam¬ 
mern aufgehoben werden. Geklammerte Ausdrücke werden grundsätzlich 
zuerst bearbeitet. Bei geschachtelten Klammerausdrücken wird grundsätzlich 
der innerste Klammerausdruck zuerst bearbeitet. 


Arithmetische Operatoren 

Es gibt acht arithmetische Operatoren. Es sind dies in der Reihenfolge ihrer 
Berücksichtigung (mathematische Hierarchie) in einem numerischen Aus¬ 
druck: 


Operator Operation Beispiel 

| Potenzierung A 1 5 

Negation -A 

*,/ Multiplikation, Gleitpunktdiv. A*5, A/5 

\ Ganzahldivision A\5 

MOD Modulo-Arithmetik A MOD 5 

+ ,- Addition, Subtraktion A + 5.A-5 


Die Ganzzahldivision und die Modulo-Arithmetik sind Besonderheiten des 
mathematischen Teils des Amiga Basic-Interpreters. 

Bei der Ganzahldivision. bei der Divisor und Dividend im Bereich zwischen 
-32768 und +32767 im Fall von kurzen Ganzzahlen und zwischen 
-2147483648 und +2147483647 im Fall von langen Ganzzahlen liegen müs¬ 
sen, werden beide vor der Division zu ganzen Zahlen gerundet. Bei Quotienten 
werden eventuelle Dezimalstellen abgeschnitten. Z.B.: 

PRINT 713, 12.9V5.89 
Z 2 
OR 



8-14 


Die Elemente der Amiga Basic-Sprache 


Bei der Modulo-Arithmetik, die eine ganzzahlige Division durchführt, werden 
zunächst beide Operanden, die im Bereich zwischen -32768 und +32767 
liegen müssen, zu ganzen Zahlen gerundet. Als Ergebnis wird hier jedoch der 
Rest der Division geliefert. Z.B.: 

PRINT 7 MOD 2; 12.9 MOD 5.89 
1 1 
Ok 


Vergleichsoperatoren 

Vergleichsoperatoren dienen dem Vergleich zweier numerischer oder Zei¬ 
chenkettenwerte. Das Ergebnis ist entweder logisch “wahr“ mit dem Wert -1 
oder logisch “falsch“ mit dem Wert 0 (Null) und wird meistens in Verbindung 
mit der IF-Anweisung (s. dort in Kapitel 9) zur Steuerung des Programmablau¬ 
fes verwendet. 


Hier sind die sechs verschiedenen Vergleichsoperatoren, die Amiga Basic 
kennt, tabellarisch zusammengestellt: 


Operator Vergleich auf 


Beispiel 


< >,> < 
< 

> 

< =,= < 
> =,= > 


Gleichheit 
Ungleichheit 
kleiner als 
größer als 

kleiner als oder gleich 
größer als oder gleich 


A = B 

A< >B, A> <B 

A<B 
A> B 

A< = B, A= < B 
A> =B, A= >B 


Wenn in einem Ausdruck sowohl arithmetische als auch Vergleichsoperatoren 
Vorkommen, so werden zuerst die arithmetischen Operatoren abgearbeitet. 


Z.B.: 


fi+B<(X—V)/Z 

Dieser Ausdruck ist “wahr“ (liefert den Wert -1), wenn der Wert von A+B 
kleiner ist als der Wert X-Y dividiert durch Z. 

Oder z.B.: 


108 IF SIN(X><0 GOTO 1000 
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Wenn derSIN(X) negativ wird, liefert der Vergleich ein “wahres“ Ergebnis (-1) 
und das Programm verzweigt nach Zeile 1000. 

Bei Zeichenkettenvergleichen wird von beiden Ketten zeichenweise der 
ASCII-Code verglichen. Es werden alle Zeichen, also auch führende und 
nachfolgende Leerstellen verglichen. Die Wirkung ist am besten an folgenden 
Beispielen zu erkennen, die alle logisch “wahr“ sind, also den Wert -1 liefern: 


"HnUS"="HftUS" 

"HnUS">"HftNS" 

"m 

"u">"u” 

X$="12”:X$<"13" 


Logische Operatoren 

Logische Operatoren dienen zum Testen von Mehrfachvergleichen, zur Bit- 
Manipulation oder zum Durchführen Boole’scher Operationen mit numeri¬ 
schen Werten. 

Ein logischer Operator verknüpft zwei Operanden als Kombination aus 
“wahr“- und “falsch“-Werten bitweise und liefert als Ergebnis einen Wert, der 
entweder als “wahr“ (von Null verschieden) oder als “falsch“ (Null) interpre¬ 
tiert wird. 

Der Interpreter führt Operationen mit logischen Operatoren in einem gemisch¬ 
ten Ausdruck nach den arithmetischen und den Vergleichsoperationen durch. 
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Der Interpreter kennt sechs verschiedene logische Operatoren, die im folgen¬ 
den in der Reihenfolge, wie sie bearbeitet werden, mit ihren Wahrheitstabellen 
dargestellt werden: 


Operator 

Operand 1 

Operand 2 

Ergebnis 

NOT (log. Komplement) 

wahr 

— 

falsch 


falsch 

- 

wahr 

AND (Konjunktion) 

wahr 

wahr 

wahr 


wahr 

falsch 

falsch 


falsch 

wahr 

falsch 


falsch 

falsch 

falsch 

OR (Disjunktion) 

wahr 

wahr 

wahr 


wahr 

falsch 

wahr 


falsch 

wahr 

wahr 


falsch 

falsch 

falsch 

XOR (exkl. ODER) 

wahr 

wahr 

falsch 


wahr 

falsch 

wahr 


falsch 

wahr 

wahr 


falsch 

falsch 

falsch 

EQV (Äquivalenz) 

wahr 

wahr 

wahr 


wahr 

falsch 

falsch 


falsch 

wahr 

falsch 


falsch 

falsch 

wahr 

IMP (Implikation) 

wahr 

wahr 

wahr 


wahr 

falsch 

falsch 


falsch 

wahr 

wahr 


falsch 

falsch 

wahr 


Genau wie die Vergleichsoperatoren über ihr Ergebnis zur Steuerung des 
Programmablaufes beitragen können, kann dies auch durch die Verknüpfung 
von zwei oder mehreren Vergleichen durch logische Operatoren geschehen, 
die ja wiederum “wahr“- und “falsch“-Werte liefern (s, a. IF-Anweisung in 
Kapitel 9). 
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Die folgenden Beispiel-Programmzeilen sollen dies verdeutlichen: 

I F D<200 AND F<4 THEN 80 
I F I > 10 OR K<0 THEN 50 
IF NOT P THEN 100 

Die logischen Operatoren arbeiten intern folgendermaßen: 

Zunächst werden die beiden Operanden in ganze, vorzeichenbehaftete Zwei- 
erkomplement-16-Bit-Zahlen im Bereich zwischen -32768 und +32767 
umgewandelt. Sind die Operanden größer oder kleiner, so wird die Fehlermel¬ 
dung 


Overflow error (Überlauf) 

angezeigt. Sind die beiden Operanden 0 und/oder-1, so liefert eine logische 
Operation ebenfalls 0 oder -1. Die Operation wird auf jeden Fall bitweise 
durchgeführt, d. h. jedes Ergebnis-Bit wird durch die beiden entsprechenden 
Bits in den Operanden bestimmt. Dabei bedeutet ein 1—Bit “wahr“ und ein 
0—Bit “falsch“. Dadurch ist es möglich, mit Hilfe der logischen Operatoren das 
Bitmuster von Speicherzellen zu testen. Z.B. kann ein Byte an einer Ein-/ 
Ausgabeschnittstelie maskiert werden, um den Zustand eines bestimmten 
Bits zu testen. Auch kann mit dem OR-Operator in einem bestimmten Byte ein 
ganz bestimmtes Bitmuster erzeugt werden. Die folgenden Beispiele sollen 
die Arbeitsweise der logischen Operatoren erläutern: 


63 AND 16 = 16 

AND 


15 AND 14 = 14 

AND 


-1 AND 8 = 8 

AND 


4 OR 2 = 6 

OR 


0000000000111111 

63 

0000000000010000 

16 

0000000000010000 = 

16 

0000000000001111 

15 

0000000000001110 

14 

0000000000001110 = 

14 

1111111111111111 

-1 

0000000000001000 

8 

0000000000001000 = 

8 

0000000000000100 

4 

0000000000000010 

2 

0000000000000110 = 

6 
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10 OR 10 = 10 

OR 


-1 OR -2 = -1 

OR 


NOT 1 = -2 

NOT 


0000000000001010 10 

0000000000001010 10 

0000000000001010 = 10 

1111111111111111 -1 

1111111111111110 -2 

1111111111111111 = -1 

0000000000000001 1 

1111111111111110 = -2 


Der Operator NOT bildet das Einerkomplement des Operanden. 


Funktionsoperatoren 

Funktionsoperatoren (Amiga Basic-Funktionen) werden dazu verwendet, an 
einem Operanden eine festgelegte Operation auszuführen. Solche in Amiga 
Basic enthaltenen Funktionen sind z.B. SQR (Quadratwurzel ziehen) oder SIN 
(trigonometrischer Sinus). Es ist auch möglich, mit Hilfe der DEF FN-Anwei- 
sung eigene Funktionen zu definieren. Einzelheiten zu den Funktionen sind in 
Kapitel 9 ausführlich beschrieben. 


8.7 Operatoren bei Zeichenketten 


Ein Zeichenkettenausdruck kann eine Zeichenkettenkonstante oder -Variable 
oder eine Kombination aus Zeichenkettenkonstanten, -variablen und -operatoren 
zur Erzeugung einer neuen Zeichenkette sein. Die Operatoren kombinieren dabei 
Zeichenketten zu neuen Zeichenketten. Amiga Basic kennt drei Typen von 
Zeichenkettenoperatoren: 

• Verkettungsoperator 

• Vergleichsoperatoren 

• Funktionsoperator oder Zeichenkettenfunktion 

Da der Zeichenkettenvergleich prinzipiell ein numerischer Vergleich ist, ist er im 
letzten Kapitel bei den Vergleichsoperatoren beschrieben. 
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Verkettungsoperator 

Zeichenketten können mit dem +-Zeichen aneinandergefügt werden, um 
neue Zeichenketten zu bilden. Z.B.: 

A$="REGEN":B$="SCHIRM” 

PRINT fl$*B$+”E" 

REGENSCHIRME 

Ok 


Zeichenkettenfunktionen 

Wie bei den numerischen Funktionen (s. Kapitel 8.6) führt die Zeichenketten¬ 
funktion an einem oder mehreren Operanden eine festgelegte Operation aus, 
die als Ergebnis eine Zeichenkette liefert. Solche in Amiga Basic enthaltenen 
Funktionen sind z.B. CHR$ (Bildung einer Ein-Zeichenkette aus einem 
ASCII-Code) oder STR$ (Bildung eines Zeichenkettenäquivalents zu einem 
numerischen Ausdruck). Es ist auch möglich, eigene Zeichenkettenfunktio¬ 
nen mit Hilfe der DEF FN-Anweisung zu definieren. Einzelheiten zu den 
Zeichenkettenfunktionen sind in Kapitel 9 ausführlich beschrieben. 
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9. Amiga Basic-Befehle,-Anweisungen, 
-Funktionen und -Variablen 


9.1 Struktur von Amiga Basic 


Der Sprachumfang der Programmiersprache Amiga Basic gliedert sich in: 

• Befehle 

• Anweisungen 

• Funktionen 

• Variablen 

Befehle werden dazu benutzt, an Programmen etwas zu bearbeiten, sie zu listen, 
zu ändern, zu löschen, zu speichern oder zu laden. Deshalb werden Befehle auch 
meistens in der Befehlsebene (Direktmodus) eingegeben. Sie können aber auch 
Bestandteil eines Programms sein. 

Anweisungen steuern den Programmablauf. Sie sind der eigentliche Inhalt des 
Programms, können aber auch im Direktmodus eingegeben werden. Die Anwei¬ 
sungen gliedern sich in 4 Gruppen: 

• Ein-/Ausgabeanweisungen für den Datenverkehr zwischen dem Rechner 
einerseits sowie Tastatur, Bildschirm, Diskettenstation, Festplatte, Drucker 
oder Datenfernübertragungsschnittstelle andererseits. 

• Grafische, akustische und Animations-Anweisungen zur Nutzung der heraus¬ 
ragenden audiovisuellen Eigenschaften des Amiga. 

• Deklarationsanweisungen für die Definition von Daten, benutzereigenen Funk¬ 
tionen, Speichersegmenten oder der Programmumgebung. 

• Steueranweisungen zur Festlegung des Programmablaufes wie Schleifen, 
Sprünge, Unterprogramm- und Unterbrechungsaufrufe. 
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Funktionen liefern als Ergebnis bestimmte Werte zur Weiterverarbeitung an das 
Programm und gliedern sich in: 

• Numerische Funktionen, die als Ergebnis Werte in gewünschter Genauigkeit 
übergeben; 

• Zeichenkettenfunktionen, die als Ergebnis eine Zeichenkette übergeben. 

Variablen des Amiga Basic dürfen nicht mit den vom Programmmierer frei 
definierbaren Variablen eines Programms verwechselt werden. Die hier gemeinten 
System-Variablen haben feste, von Basic vorgegebene Namen und Funktionen. 
Ihnen wird beim Aufruf vom Interpreter ein Wert zugewiesen, der bestimmte 
Funktionszustände des Interpreters oder Rechnersystems zu einem bestimmten 
Zeitpunkt beschreibt. Es gibt numerische und Zeichenketten-Systemvariablen. 


9.2 Struktur und Syntax der Beschreibungen 


Im Kapitel 9.3 werden alle Befehle, Anweisungen, Funktionen und Variablen, die 
Amiga Basic kennt, detailliert und an Hand von Beispielen beschrieben. Die 
einzelnen Beschreibungen sind alphabetisch nach den Namen geordnet und nach 
dem folgenden Schema gegliedert: 

Format: Hier ist die exakte Schreibweise für einen Befehl, eine Anwei¬ 

sung, Funktion oder Variable angegeben. Dabei gelten die 
folgenden Syntax-Regeln: 

1. Alle Wörter in Großbuchstaben sind Amiga Basic-Schlüssel- 
wörter, deren Schreibweise wie angegeben verbindlich ist. 
Bei der Eingabe über Tastatur können dabei Klein- oder 
Großbuchstaben verwendet werden, da der Interpreter diese 
Schlüsselwörter generell in Großbuchstaben umwandelt. 

2. Alle Angaben in kursiver Groß- und Kleinschrift stellen 
Parameter dar, die vom Anwender eingesetzt werden müs¬ 
sen. 

3. Angaben zwischen eckigen Klammern ([]) sind wahlfrei. 
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4. Eine Folge von Punkten (.. .) hinter einer Angabe bedeutet, 
daß diese Angabe, falls erforderlich, mehrmals spezifiziert 
werden kann. 

5. Alle Sonderzeichen außer den eckigen Klammern, also , ; - 
= () ’, müssen da, wo sie stehen, auch angegeben werden. 

6. Bei den Parameterangaben haben die dort verwendeten 
Abkürzungen folgende Bedeutung: 

x,y,z beliebige numerische Ausdrücke 

i,j,k,m,n beliebige ganzzahlige Ausdrücke 

x$,y$ beliebige Zeichenkettenausdrücke 

v,v$ numerische oder Zeichenkettenvariablen 

Bedeutung: Hier wird die Wirkung des jeweiligen Befehls oder der Anwei¬ 

sung, Funktion oder Variablen detailliert beschrieben, und die 
Parameter und ihre Definitionsbereiche werden erläutert. 


Beispiel: Ein oder mehrere Beispiele bei jeder Beschreibung zeigen, wie 

die einzelnen Befehle, Anweisungen, Funktionen und Variablen 
angewendet werden, und zeigen auch Besonderheiten auf. 


Anmerkungen: Besondere Eigenschaften der einzelnen Befehle, Anweisungen, 
Funktionen und Variablen werden hier erläutert. 


9.3 Beschreibung der einzelnen Befehle, Anweisungen, Funktionen 
und Variablen 


Zur Erleichterung des Auffindens eines bestimmten Amiga Basic-Befehls oder 
einer -Anweisung, -Funktion oder -Variablen sind die nachfolgenden Beschrei¬ 
bungen nicht entsprechend der in Kapitel 9.1 beschriebenen Sprachstruktur von 
Amiga Basic gegliedert, sondern es sind alle Sprachelemente zusammengefaßt 
und alphabetisch geordnet. 

Für den schnellen Überblick sind den einzelnen Beschreibungen zunächst nach 
Sprachelementen geordnet die einzelnen Befehle, Anweisungen, Funktionen und 
Variablen mit einem kurzen Stichwort über ihre Wirkung in alphabetischer Reihen¬ 
folge in Listen vorangestellt. Dabei sind jedoch in den meisten Fällen alle 
Parameter weggelassen. 
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Befehle 

CHDIR 

CLEAR 

CONT 

DELETE 

FILES 

KILL 

LIST 

LUST 

LOAD 

MERGE 

NAME 

NEW 

RUN 

SAVE 


Ein anderes als das aktuelle Diskverzeichnis wird aktuali¬ 
siert. 

Alle Programmvariablen werden gelöscht und es wird der 
Arbeitsspeicherbereich definiert. 

Ein unterbrochenes Programm wird fortgesetzt. 

Bestimmte Programmzeilen werden gelöscht. 

Der Inhalt des aktuellen Diskverzeichnisses wird auf dem 
Bildschirm dargestellt. 

Eine bestimmte Disk-Datei wird gelöscht. 

Bestimmte Programmzeilen werden auf dem Bildschirm 
oder einer anderen Ausgabeeinheit gelistet. 

Bestimmte Programmzeilen werden auf dem Drucker ge¬ 
listet. 

Eine Programmdatei wird von einer Eingabeeinheit geladen 
und ggf. gestartet. 

Eine Programmdatei wird von einer Eingabeeinheit zum 
hauptspeicherresidenten Programm dazugeladen. 

Eine Diskdatei wird umbenannt. 

Das hauptspeicherresidente Programm und alle seine Va¬ 
riablen werden gelöscht. 

Das hauptspeicherresidente Programm wird von einer ge¬ 
wünschten Zeile an gestartet. 

Das hauptspeicherresidente Programm wird in wählbarem 
Format auf Disk gespeichert. 
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Befehle (Fortsetzung) 

SYSTEM Rückkehr aus Amiga Basic zum Arbeitstisch (Workbench). 

TRON, TROFF Die Programmablaufverfolgung wird ein- bzw. ausge¬ 

schaltet. 
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Ein-/Ausgabeanweisungen 


BEEP 

CLOSE 

CLS 

DATA 

GET# 

INPUT 
INPUT # 

LIBRARY 


Kurzes audiovisuelles Signal. 

Eine Datei wird geschlossen. 

Der Bildschirm wird gelöscht. 

Es werden Konstanten im Speicher abgelegt, die mit READ 
gelesen werden sollen. 

Es wird ein Satz aus einer Datei mit wahlfreiem Zugriff 
gelesen. 

Es werden Daten von der Tastatur gelesen. 

Es werden Daten aus einer bestimmten, sequentiellen 
Datei gelesen. 

Es wird eine Bibliothek mit Maschinensprache-Unterpro¬ 
grammen geöffnet. 


LINE INPUT Es werden alle über Tastatur eingegebenen Zeichen bis zur 

Return-Taste als eine Zeile gelesen. Es gibt keine Trennzei¬ 
chen (z.B. Komma). 

LINE INPUT # Es werden alle Zeichen bis zum Wagenrücklaufcode als 

eine Zeile aus einer sequentiellen Datei gelesen. 

LOCATE Der Cursor wird an eine wählbare Bildschirmposition ge¬ 

stellt. 

LPRINT Es werden Daten auf dem Drucker ausgegeben. 

LPRINT USING Es werden Daten in einem wählbaren Format auf dem 
Drucker ausgegeben. 


LS ET 


Es werden Daten linksbündig in Datenfeldern, die in einem 
Datenpuffer für wahlfreien Zugriff definiert sind, abgelegt 



Befehle, Anweisungen und Funktionen 


9-7 


Ein-/Ausgabeanweisungen (Fortsetzung) 


OPEN Es wird eine Datei oder eine Ein-/Ausgabeeinheit zur 

Datenein- oder -ausgabe eröffnet. 

POKE Ein Byte wird an einer wählbaren Adresse in den Hauptspei¬ 

cher geschrieben. 

PÖKEL Eine lange Ganzzahl wird an einer wählbaren Adresse in 

den Hauptspeicher geschrieben. 

POKEW Eine kurze Ganzzahl wird an einer wählbaren Adresse in 

den Hauptspeicher geschrieben. 

PRINT Es werden Daten auf dem Bildschirm angezeigt. 

PRINT USING Es werden Daten in einem wählbaren Format auf dem 

Bildschirm angezeigt. 

PRINT # Es werden Daten in eine sequentielle Datei ausgegeben. 

PRINT #, USING Es werden Daten in einem wählbaren Format in eine se¬ 
quentielle Datei ausgegeben. 

PUT # Es werden Daten aus einem Puffer für wahlfreien Zugriff in 

eine Datei geschrieben. 

READ Es werden Daten aus DATA-Anweisungszeilen gelesen 

und Variablen zugewiesen 

RSET Es werden Daten rechtsbündig in Datenfeldern, die in 

einem Datenpuffer für wahlfreien Zugriff definiert sind, 
abgelegt. 

SCROLL Ein definierter, rechteckiger Bereich im aktuellen Ausga¬ 

befenster wird in eine wählbare Richtung gerollt. 

WRITE Es werden Daten auf dem Bildschirm angezeigt. 


VyRITE # 


Es werden Daten in eine sequentielle Datei ausgegeben. 
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Graphische, akustische und 
Animations-Anweisungen 

AREA Definiert einen Punkt eines Polygons. 

AREAFILL Malt ein Polygon mit einem definierten Muster aus. 

CIRCLE Malt eine Ellipse mit wählbarem Radius und Mittelpunkt. 

COLOR Setzt Vorder- und Hintergrundfarbe. 

GET Liest grafische Darstellungen vom Bildschirm als binäre 

Information in ein Ganzzahlfeld. 

LINE Malt eine Linie oder ein Viereck. 

OBJECT.AX/AY Definiert die Beschleunigung eines grafischen Objektes. 

OBJECT.CLIP Definiert den Darstellungsbereich für grafische Objekte. 

OBJECT.CLOSE Gibt den für nicht mehr benötigte grafische Objekte reser¬ 
vierten Speicherplatz wieder frei. 

OBJECT.HIT Legt für ein grafisches Objekt fest, ob dessen Kollisionen 

Unterbrechungsereignisse sind oder nicht. 

OBJECT.ON/OFF Macht ein oder mehrere grafische Objekte sichtbar oder 
unsichtbar. 

OBJECT.PLANES Definiert zwei 8-Bit-Masken, mit denen die Farbdarstellung 
für ein bestimmtes Objekt beeinflußt werden kann. 

OBJECT. Setzt die Priorität, mit der ein grafisches Objekt gegenüber 

PRIORITY anderen Objekten vom System gezeichnet wird. 

OBJECT.SHAPE Definiert Form, Farben, Ort und weitere Attribute für ein 
grafisches Objekt. 

OBJECT. Setzt angegebene grafische Objekte in Bewegung oder 

START/STOP hält sie an. 
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Graphische, akustische und 
Animations-Anweisungen (Fortsetzung) 

OBJECT.VX/VY Definiert für ein angegebenes grafisches Objekt die Ge¬ 
schwindigkeit in X- oder Y-Richtung. 

OBJECT.X/Y Plaziert ein angegebenes grafisches Objekt bei einer defi¬ 

nierten Position im Ausgabefenster. 

PAINT Malt eine geschlossene Fläche in einer wählbaren Farbe 

aus. 

PALETTE Definiert einen Farbton für eine Farbkennung. 

PATTERN Definiert ein Muster, mit dem Linien und/oder Flächen 

gemalt werden. 

PRESET/PSET Zeichnet an einer definierten Position im Ausgabefenster 
einen Bildpunkt. 

PUT Überträgt aus einem Ganzzahlfeld binäre Informationen als 

grafische Darstellung in das Ausgabefenster. 

SAY Gibt eine Phonem-Code-Zeichenkette als verständliche 

Sprache beliebiger Nationalität über einen wählbaren Ton¬ 
kanal aus. 

SCREEN Definiert die Attribute für einen neuen oder schließt einen 

existierenden Bildschirm 

SOUND Gibt einen Ton wählbarer Frequenz. Dauer und Lautstärke 

über einen wählbaren Ton-Kanal aus oder hält die Tonaus¬ 
gabe an. 

WAVE Definiert die Form von Tonwellen für einen angegeben 

Tonkanal 


WINDOW 


Definiert, aktualisiert oder schließt ein Ausgabefenster. 
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Deklarationsanweisungen 

DECLARE 

FUNCTION 

Deklariert eine Maschinensprache-Routine aus einer Bi¬ 
bliothek als eine aufrufbare Funktion. 

DIM 

Die maximale Anzahl von Elementen für Feldvariablen wird 
festgelegt und Speicherplatz dafür reserviert. 

ERASE 

Feldvariablen und dafür reservierter Speicherplatz werden 
gelöscht. 

ERROR 

Bestimmte Fehler werden simuliert oder anwenderspezifi¬ 
sche Fehlercodes definiert. 

FIELD 

Es wird Platz für Variableninhalte in einem Puffer für Dateien 
mit wahlfreiem Zugriff reserviert. 

LET 

Der Wert eines beliebigen Ausdrucks wird einer wählbaren 
Variablen zugewiesen. 

MENU 

Deklariert ein Anwender-Menü oder setzt die Menü-Leiste 
zurück. 

MID$ 

Ein Teil einer Zeichenkette wird durch eine andere Zeichen¬ 
kette ersetzt (s.a. MID$-Funktion). 

OPTION BASE 

Der kleinste Indexwert für alle definierten Feldvariablen 
wird festgelegt. 

RANDOMIZE 

Der Zufallszahlengenerator wird mit einem neuen Anfangs¬ 
wert gestartet 

REM 

Einzelne Kommentare oder ganze Kommentarzeilen wer¬ 
den ins Programm eingefügt. 

WIDTH 

Die Zeilenlänge und Druckzonenbreite werden für eine 
Ausgabeeinheit (Bildschirm, Drucker, Datenfernübertra¬ 
gungskanal) festgelegt. 
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Steueranweisungen 

BREAK 

ON/OFF/STOP 

Die Reaktionsfähigkeit bei Programmunterbrechung durch 
den Anwender wird aktiviert oder inaktiviert. 

CALL 

Ein Amiga Basic-, ein Maschinensprache-Unterprogramm 
oder eine Bibliotheksroutine werden aufgerufen, und es 
werden wahlweise Parameter übergeben. 

CHAIN 

Ein anderes Amiga Basic-Programm wird aufgerufen, und 
es werden Variablen übergeben oder es werden Pro¬ 
grammüberlagerungen ausgeführt. 

COLLISION 

ON,OFF,STOP 

Die Unterbrechungsreaktionsfähigkeit für Objekt-Kollisio¬ 
nen untereinander oder mit Fensterbegrenzungen wird 
aktiviert oder inaktiviert. 

COMMON 

Wählbare Variablen werden an ein durch CHAIN (s. oben) 
aufgerufenes Programm übergeben. 

END 

Ein laufendes Amiga Basic-Programm wird nach der Schlie¬ 
ßung aller offenen Dateien beendet. 

FOR.. .NEXT 

Alle Programmzeilen zwischen der FOR- und der NEXT- 
Anweisung werden in einer wählbaren Anzahl von Durch¬ 
läufen wiederholt ausgeführt. 

GOSUB 

Das Programm verzweigt in eine Subroutine mit wählbarer 
Zeilennummer oder Sprungmarke. 

GOTO 

Das Programm verzweigt zu einer wählbaren Programm¬ 
zeile. 

IF. .THEN. .ELSE 

Das Programm verzweigt abhängig vom logischen Wahr¬ 
heitsgehalt eines numerischen Ausdrucks in verschiedene 
Programmteile. 

MENU 

ON/OFF/STOP 

Die Unterbrechungsreaktionsfähigkeit bei Menübenutzung 
durch den Anwender wird aktiviert. 
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Steueranweisungen (Fortsetzung) 


MOUSE Die Unterbrechreaktionsfähigkeit bei Bestätigung der 

ON/OFF/STOP Maus-Auswahltaste wird aktiviert oder inaktiviert. 

ON BREAK GOSUB Eine Programmverzweigung zu einer wählbaren Pro¬ 

grammzeile bei Programmunterbrechung durch den An¬ 
wender wird ausgeführt. 

ON COLLISION Eine Programmverzweigung zu einer wählbaren Zeile bei 

GOSUB Programmunterbrechung durch Objekt-Kollision wird aus¬ 

geführt. 

ON ERROR GOTO Eine Programmverzweigung zu einer wählbaren Pro¬ 

grammzeile bei Unterbrechung durch eine Fehlermeldung 
wird ausgeführt. 

ON.. .GOSUB. .. Es wird abhängig vom Wert eines numerischen Ausdrucks 
zu einer von mehreren angegebenen Subroutinen ver¬ 
zweigt. 

ON.. .GOTO. .. Es wird abhängig vom Wert eines numerischen Ausdrucks 
zu einer von mehreren angegebenen Programmzeilen ver¬ 
zweigt. 

ON MENU GOSUB Eine Programmverzweigung zu einer wählbaren Pro¬ 

grammzeile bei Menü-Wahl durch den Anwender wird 
ausgeführt. 

ON MOUSE GOSUB Eine Programmverzweigung zu einer wählbaren Pro¬ 
grammzeile bei Betätigung der Auswahltaste der Maus wird 
ausgeführt. 

ON TIMER(n) Eine Programmverzweigung zu einer wählbaren Pro- 

GOSUB grammzeile bei Unterbrechung durch Ablauf einer spezifi¬ 

zierten Zeit wird ausgeführt. 

RESTORE Der Lesezeigerder READ-Anweisung wird auf eine spezifi¬ 

zierte DATA-Zeile im Programm gestellt. 
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Steueranweisungen (Fortsetzung) 


RESUME Das Programm verzweigt nach Ausführung einer Fehlerbe¬ 

arbeitungsroutine zurück ins Hauptprogramm. 

RETURN Das Programm verzweigt nach Ausführung einer Subrouti¬ 

ne (ggf. an eine spezifizierte Zeile) ins Hauptprogramm 
zurück. 

SLEEP Ein Amiga Basic-Programm wird angehalten, bis ein Unter¬ 

brechungsereignis eintritt. 


STOP Das Programm wird mit einer Meldung unterbrochen und 

der Interpreter in die Befehlsebene (Direktmodus) versetzt. 

SUB Benennt ein Amiga Basic-Unterprogramm und leitet es ein. 

SWAP Die Werte zweier Variablen gleichen Typs werden ver¬ 

tauscht. 

TIMER Die Unterbrechungsreaktionsfähigkeit bei Ablauf einer be- 

ON/OFF/STOP stimmten Zeit wird aktiviert oder inaktiviert. 

WHILE.. .WEND Eine Schleife wird solange ausgeführt, wie ein spezifizierter 
Ausdruck logisch “wahr“ (von Null verschieden) ist. 
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Numerische und logische Funktionen 

(liefern numerische oder logisch interpretierbare Werte) 


ABS(x) Liefert den Absolutwert des Arguments. 

ASC(xS) Liefert den ASCII-Code des ersten Zeichens des Argu¬ 

ments. 

ATN(x) Liefert den Arcustangens des im Bogenmaß anzugebenden 

Arguments. 

CDBL(x) Liefert den Wert des Arguments als doppeltgenaue Zahl. 

CINT(x) Liefert eine ganze Zahl durch Runden des Absolutwerts 

des Arguments. 

CLNG(x) Liefert eine lange Ganzzahl durch Runden des Absolutwer¬ 

tes des Arguments. 

COLLISION(/>) Liefert kollisionsbezogene Parameter eines grafischen Ob¬ 
jektes. 

COS(x) Liefert den Cosinus des im Bogenmaß anzugebenden 

Arguments. 

CSNG(x) Liefert den Wert des Arguments als einfachgenaue Zahl. 

CVI(x£) Liefert das als Zahl interpretierte Argument in der spezifi- 

CVL(x$) zierten Genauigkeit 

CVS(*$) 

CVD(xj) 

EOF(/) Liefert die logische Dateiende-Bedingung (-1 oder 0) für 

die Datei f. 

EXP(x) Liefert den Exponentialfunktionswert e hoch x. 


FIX(x) 


Liefert eine ganze Zahl durch Abschneiden der Stellen 
hinter dem Dezimalpunkt des Arguments. 
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Numerische und logische Funktionen 

(Fortsetzung) 


FRE(x) Liefert je nach Argument verschiedene Aussagen über 

verfügbaren Speicherbereich. 

INSTR(/>,x$,y£) Liefert die Position des ersten Auftretens einer Teilzeichen- 



kette in einer Zeichenkette. 

INT(x) 

Liefert den größten ganzzahligen Wert, der kleiner oder 
gleich dem Argument ist. 

LBOUND 

Liefert die untere Grenze der angegebenen Dimension 
einer Feldvariablen. 

LEN(x$) 

Liefert die Länge des Zeichenkettenarguments. 

LOC(n) 

Liefert die 

• Nummer des letzten gelesenen oder geschriebenen 
Datensektors bei einer Direktzugriffsdatei; 

• Anzahl der aus einer sequentiellen Datei gelesenen 
Datensektoren. 

LOF(/j) 

Liefert die Länge einer spezifizierten Datei. 

LOG(x) 

Liefert den natürlichen Logarithmus des Arguments. 

LPOS(n) 

Liefert die Position des zuletzt auf dem spezifizierten 
Drucker gedruckten Zeichens im Druckpuffer. 

MENU(n) 

Liefert die Nummer des zuletzt gewählten Menu-Titels oder 
-Punktes. 

MOUSE(n) 

Liefert je nach Argument verschiedene Informationen über 
den Status der Maus-Auswahltaste oder die Position des 
Mauszeigers innerhalb des aktiven Fensters. 


OBJECT.VX/VY 


Liefert für ein angegebenes grafisches Objekt in Geschwin¬ 
digkeit in X- bzw. Y-Richtung in Bildpunkten/Sekunde. 
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Numerische und logische Funktionen 

(Fortsetzung) 


OBJECT.X/Y 

PEEK(/>) 

PEEKL(n) 

PEEKW(/>) 

POINT(*,y) 

POS(/») 

RND(x) 

SADD(x) 

SGN(x) 

SIN(x) 

SQR(x) 

STICK(/j) 

STRIG(n) 

TAN(x) 


Liefert die Koordinaten der linken oberen Ecke des Recht¬ 
eckes, in dem das angegebene Objekt definiert ist. 

Liefert das Dezimaläquivalent des binären Inhaltes der 
Hauptspeicheradresse n als Byte-Wert. 

Liefert das Dezimaläquivalent des binären Inhaltes der 
Hauptspeicheradresse n als lange Ganzzahl. 

Liefert das Dezimaläquivalent des binären Inhaltes der 
Hauptspeicheradresse n als kurze Ganzzahl. 

Liefert die Farbkennung eines bestimmten Bildpunktes. 

Liefert die aktuelle Spaltenposition des Cursors. 

Liefert eine Zufallszahl. 

Liefert die aktuelle Speicheradresse des ersten Zeichens 
eines angegebenen Zeichenkettenausdrucks. 

Liefert das Vorzeichen des Argumentes als numerischen 
Wert (-1, 0, 1). 

Liefert des Sinus des im Bogenmaß anzugebenden Argu¬ 
ments. 

Liefert die Quadratwurzel des Arguments. 

Liefert die Bildschirmkoordinaten eines wählbaren Joy¬ 
sticks (Spielpult). 

Liefert den Status eines wählbaren Joystick-Knopfes. 

Liefert den Tangens des im Bogenmaß anzugebenden 
Arguments. 
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Numerische und logische Funktionen 

(Fortsetzung) 


TIMER 

Liefert die Anzahl der Sekunden, die seit Mitternacht oder 
Systemwiederanlauf vergangen sind. 

UBOUND 

Liefert die obere Grenze der angegebenen Dimension einer 
Feldvariablen. 

VAL(xS) 

Liefert das numerische Äquivalent eines Ziffern-Zeichen- 
kettenausdrucks. 

VARPTR(v) 

Liefert die Adresse des ersten Datenbytes einer wählbaren 
Variablen. 

WINDOW(n) 

Liefert je nach Argument verschiedene Informationen über 
das aktuelle Ausgabefenster. 
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Zeichenkettenfunktionen 

(liefern Zeichenketten) 


CHR$(/>) Liefert ein Zeichen mit dem ASCII-Code n. 

HEX$(n) Liefert die hexadezimale Darstellung des Arguments als 

Zeichenkette. 

INKEY$ Liefert ein Zeichen von der Tastatur. 

INPUT$ Liefert eine Zeichenkette wählbarer Länge von der Tastatur 

oder einer sequentiellen Eingabedatei oder -einheit. 

LEFT$(x£,n) Liefert eine Teilzeichenkette aus den ersten n Bytes von x$. 

MID$(x£/>,/n) Liefert eine Teilzeichenkette der Länge m von der Position n 

an in x$. 

MKI$(x) Interpretiert je nach Genauigkeit das Argument als unter- 

MKL$(x) schiedlich lange Zeichenkette 

MKS$(x) 

MKD$(x) 

OCT$(/j) Liefert die oktale Darstellung des Arguments als Zeichen¬ 

kette. 

PTAB(n) Die Druckposition wird auf die angegebene Zahl von Bild¬ 

punkten vom linken Fensterrand nach rechts gesetzt. 

RIGHT$(x$,n) Liefert eine Teilzeichenkette aus den letzten n Bytes von 

x$. 

SPACE$(/>) Liefert eine Zeichenkette aus n Leerstellen. 

SPC(n) Liefert bei der Ausgabe auf Bildschirm, Drucker oder in 

sequentielle Datei n Leerstellen. 


STR$(n) 


Liefert das Zeichenkettenäquivalent des numerischen Ar¬ 
guments. 
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Zeichenkettenfunktionen (Fortsetzung) 


STRING$ Liefert ein Zeichen eines wählbaren ASCII-Codes oder eine 

Zeichenkette wählbarer Länge, die aus dem ersten Zeichen 
einer wählbaren Zeichenkette besteht. 

TAB(n) Liefert vor der Ausgabe von Daten auf Bildschirm, Drucker 

oder in sequentielle Datei Leerstellen bis zum Erreichen der 
durch n definierten Druckposition. 

TRANSLATE$(x$) Erzeugt und übergibt eine Folge von Phonem-Codes für 
die angloamerikanische Sprachausgabe. 

UCASE$(x$) Übergibt eine Kopie einer angegebenen Zeichenkette, in 

der alle Kleinbuchstaben in Großbuchstaben gewandelt 
sind. 



9-20 

Befehle, Anweisungen und Funktionen 

Systemvariablen 

CSRLIN 

Enthält die Zeilenposition des Cursors in der aktuellen 
Bildschirmseite. 

DATE$ 

Enthält das aktuelle Tagesdatum, das die Systemuhr lie¬ 
fert. 

ERL 

Enthält die Nummer der Programmzeile, in der der Interpre¬ 
ter zuletzt einen Fehler diagnostiziert hat. 

ERR 

Enthält den Code des letzten vom Interpreter diagnostizier¬ 
ten Fehlers. 

TIMES 

Enthält die aktuelle Zeit, die die Systemuhr liefert. 
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ABS-Funktion 


Format: p=ABS(x) 

Bedeutung: Es wird der Absolutwert des numerischen Ausdrucks x überge¬ 

ben. Der Absolutwert ist entweder 0 (Null) oder positiv. 

Ok 

PRINT RBS(Z~C5-8)) 

6 

Ok 


Beispiel: 
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AREA-Anweisung 


Format: AREA [STEP] (x,y) 

Bedeutung: Definiert einen Punkteines Polygons, das mit der AREAFILL-An- 

weisung (s. dort) ausgemalt werden kann. 

x,y Absolute Bildschirmkoordinaten in Bildpunkten für den 
Polygon-Eckpunkt. Die maximal erlaubten Koordinatenwerte 
hängen von der Größe des aktuellen Ausgabe-Fensters ab (s. 
WINDOW-Anweisung und -Funktion). 

STEP Wird STEP angegeben, so sind x,yzur aktuellen Position 
des grafischen Cursors relative Koordinaten. 


Beispiel: 


s. AREAFILL-Anweisung. 
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AREAFILL-Anweisung 


Format: AREAFILL [Modus] 

Bedeutung: Malt das durch mehrere AREA-Anweisungen (s. dort) definierte 

Polygon mit einem wählbaren Muster aus. 

Modus Ein ganzahliger Wert von 0 oder 1, der festlegt, wie das 
Polygon ausgemalt wird. 

0 Das Polygon wird mit dem mit der PATTERN-Anweisung (s. 
dort) festgelegten Muster ausgemalt. Dies ist der voreinge¬ 
stellte Wert. Bei voreingestelltem PATTERN-Wert wird das 
Polygon weiß ausgemalt. 

1 Das Polygon-Innere wird invertiert ausgemalt. Bei vorein¬ 
gestelltem PATTERN-Wert bedeutet dies orange. 

Beispiel: areaclb.ib) 

AREA STEP (0,40) 

AREA STEP (40, -40) 

AREAFILL 

Dies Beispiel zeichnet oben links im Ausgabe-Fenster ein auf 
der Spitze stehendes, rechtwinkeliges Dreieck, das weiß aus¬ 
gemalt wird. 
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ASC-Funktion 


Format: v= ASC(x$) 

Bedeutung: Es wird der ASCII-Code des ersten Zeichens der Zeichenkette 

x$ als Dezimalwert übergeben. Der ASCII-Code ist ein numeri¬ 
scher Wert (s. Anhang A). Enthält x$ keine Zeichen (Leerstring), 
so meldet Amiga Basic den Fehler 

I1 legal function call 

(unerlaubter Funktionsaufruf). 

Ok 

X$= H Zahr' : PRINT ftSCCX$) 

90 
Ok 


Beispiel: 
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ATN-Funktion 


Format: p=ATN(x) 

Bedeutung: Es wird ein Wert im Bogenmaß übergeben, der aus dem numeri¬ 

schen Ausdruck xerrechnet wird und zwischen -PI/2 und + PI/2 
liegt. Das Ergebnis ist also der Hauptwert des Arcustangens. Für 
die Umrechnung in das Gradmaß gilt 

WINKEL=180/PI*ATN(x) 


Beispiel 1: ok 

PRINT 8TNC 3 ) 
1.249046 
Ok 


Beispiel 2: pi=3 .141593 

BOGEN=«TN(1) 

GRflD= BOGEN-180/PI 

PRINT BOGEN, GRAD . 7853982 45 

Ok 


Anmerkungen: • Der Hauptwert des Arcustangens wird in einfacher Ge¬ 
nauigkeit berechnet, wenn das Argument ebenfalls einfach 
genau ist und in doppelter Genauigkeit bei doppeltge¬ 
nauem Argument. 
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BEEP-Anweisung 

Format: 

BEEP 

Bedeutung: 

Es wird für ca. eine Viertelsekunde ein Ton über den Lautspre¬ 
cher ausgegeben. Zusätzlich blitzt die Bildschirmanzeige kurz 
auf. 

Beispiel: 

if FREtexiee then 

BEEP 

LOCOTE 17» 1 

PRINT"Speichepüberlauf:”j 

PR I MT” Fenster- verkleinern” 

END IF 

Anmerkungen: 

• BEEP wirkt genau wie PRINT CHR$(7). 




Befehle, Anweisungen und Funktionen 


9-27 


BREAK-Anweisung 


Format: BREAK ON 

BREAK OFF 
BREAK STOP 

Bedeutung: Die Reaktionsfähigkeit bei Programmunterbrechung durch den 

Anwender wird aktiviert oder inaktiviert. 


Beispiel: break on 

ON BREBK GOSUB Hinweis 

DIM PREIS(99), EI NGC 99)»AUSGC99),BEST(99) 

STUECKZ=2000 

OPEN "’O” , Hl, "LAGER" 

FOR 1 = 1 TO STUECKZ 

URITEttl, PREISCI)iEI NGC I ),AUSG(I),BEST(I) 

NEXT I 

CLOSE Hl: BREAK OFF 

I NPUT "Liste drucken ( J/r») "} ANTW$ 

I F ANTW$="j” THEN BREAK ON : GOSUB DRUCK 
END 

H i nuje i s : 

CLS:BEEP 

PRINT"Waehrend des Schreibens keine Unterbre 
chung mög I ich” 

RETURN 

Anmerkungen: • Die Anweisung BREAK ON muß ausgeführt werden, um 
eine Unterbrechungsverzweigung mit Hilfe der Anweisung 
ON BREAK GOSUB (s. dort) zu erreichen, wenn die Tasten¬ 
kombination Amiga-. gedrückt oder Stop aus dem Run- 
Menü gewählt wird. 


• Nach BREAK OFF kann bei Programmunterbrechung nicht 
mehr programmiert verzweigt werden. 

• Nach BREAK STOP speichert Amiga Basic eine Programm¬ 
unterbrechung durch den Anwender, unterbricht das Pro¬ 
gramm mit einer Verzweigung aber erst, sobald eine 
BREAK ON-Anweisung gegeben wird. 
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C ALL-An weisu ng 


Format: 

Syntax 1: [CALL] Sprungmarke [( Argumentliste )] 

Syntax 2: [CALL] num Var [(Argumentliste)] 

Bedeutung: Es wird ein Amiga Basic-Ünterprogramm, wie mit der SUB-An- 

weisung (s. dort) definiert (Syntax 1), ein Maschinenspra¬ 
che-Unterprogramm (Syntax 2) oder eine Maschinensprache- 
Subroutine aus einer Bibliothek, wie mit der LIBRARY-Anwei- 
sung (s. dort) definiert (Syntax 2) aufgerufen und es werden 
wahlweise Parameter übergeben. Das Schlüsselwort CALL kann 
weggelassen werde. In diesem Fall können auch die Klammern 
um Argumentliste weggelassen werden. Die drei Bedeutungen 
der CALL-Anweisung werden im folgenden beschrieben: 


Aufruf von Amiga Basic-Unterprogrammen 

Amiga Basic-Unterprogramme werden mit der SUB-Anweisung (s. dort) 
benannt und eingeleitet. Es können Variablen oder auch Ausdrücke als 
Parameter übergeben werden. Variablen werden durch Referenz, Ausdrücke 
durch ihren Wert übergeben (s. dazu Kapitel 6.1). Z.B.: 

SUB ALPHA tx.y) STfITIC 
END SUB 

CALL ALPHA (a,b) 

Näheres zu Amiga Basic-Unterprogrammen und der Parameterübergabe 
finden Sie in Kapitel 6.1. 


Aufruf von Maschinensprache-Unterprogrammen 

Die CALL-Anweisung ist die einzige Möglichkeit, die Programmsteuerung an 
ein externes Unterprogramm zu übertragen. In diesem Fall identifiziert der 
Name eine einfache Variable, deren Wert eine Adresse darstellt, die wiederum 
den Einsprungpunkt des Unterprogramms im Hauptspeicher angibt. Der 
Name darf kein Element einer Feldvariablen sein. 
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Die Argumentliste enthält die Parameter, die an das Unterprogramm überge¬ 
ben werden sollen. Die Parameter werden gemäß den Aufrufkonventionen der 
Programmiersprache C übergeben. Sie müssen entweder vom Typ kurze oder 
lange Ganzzahl sein; andernfalls wird eine Type Mismatch (fehlende Typ- 
übereinstimmung)-Fehlermeldung erzeugt. Die Adresse einer Variablen einfa¬ 
cher oder doppelter Genauigkeit kann mit Hilfe der VARPTR-Funktion über¬ 
geben werden: 

CALL Rout ine( UARPTRC x) ) 

Achtung: Es muß sichergestellt sein, daß die Maschinenroutine auf einer 
geraden Speicheradresse beginnt, sonst ist ein Systemabsturz unvermeid¬ 
lich. 

Die Adresse einer Zeichenkette kann mit Hilfe der SADD-Funktion übergeben 
werden: 

CALL Rout ine( SADDC X$) ) 

In dem folgenden Beispiel ist die Variable, deren Wert den Einsprungpunkt der 
Routine darstellt, eine kurze Ganzzahl (&) (Bei 24—Bit-Adressen muß eine 
lange Ganzzahl-Variable verwendet werden): 


a=0:b=B 

DII-I CodeXt 100) 

FOR i = 0 TO 90 

READ CodeXt i ) 

NEXT i 

CodeAdr&=UARPTR(Code*(0)) 

CALL CodeftdrÄ(a,b) 

Weitere Einzelheiten zum Aufruf von Maschinensprache-Unterprogrammen 
finden Sie in Kapitel 6.2. 


Aufruf von Bibliotheksroutinen 

Bibliotheksroutinen sind spezielle Amiga-Programmdateien, die während der 
Laufzeit dynamisch mit Amiga Basic zusammengebunden werden. Parameter 
werden entsprechend den Aufrufkonventionen der Sprache C mit ihrem Wert 
übergeben. Z.B.: 


LIBRARY "graph ics. 1 ibrary" 
CALL Draw(50,60) 
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Bei diesem Beispiel wird eine Variable namens Draw erzeugt. Dann wird die 
Information darüber, wo sich die Routine im Speicher befindet, zugewiesen. 
Aus diesem Grund kann die Variable nicht vom Typ Ganzzahl sein. 

So würde die Anweisungsfolge 

DEFINT fi-Z 
CALL Drau(5B, 60) 

zu der Fehlermeldung Type Mismatch (fehlende Typübereinstimmung) füh¬ 
ren, wohingegen 

DEFINT fi-Z 

Call DrauttC 50,60) 

akzeptiert würde, da die Definition einer doppeltgenauen Gleitpunktvariablen 
mit Hilfe des #-Zeichens vor der globalen Typdefinition mit DEFINT Priorität 
hat. 

Achtung: Da das Schlüsselwort CALL weggelassen werden kann, kann ein 
Aufruf auch mit der Syntax 

Name Argumentliste 

ausgeführt werden. Solch eine CALL-Anweisung kann mit einer alphanumeni- 
schen Sprungmarke verwechselt werden. Zur Verdeutlichung: 

ALPHfi: LET fi=5 

Bei diesem Beispiel ist nicht eindeutig klar, ob entweder ein Unterprogramm 
namens ALPHA ohne Argumentliste aufgerufen werden soll, oder ob der Anwei¬ 
sung LET A = % die alphanumerische Sprungmarke ALPHA: vorangestellt ist. In 
einem solchen Fall würde Amiga Basic von einer Sprungmarke anstatt von einem 
argumentlosen Unterprogrammaufruf ausgehen. 

Soll ein Unterprogrammaufruf nach der Klausel THEN oder ELSE bei einer 
IF-Anweisung erfolgen, muß das Schlüsselwort CALL angegeben werden. 
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CDBL-Funktion 


Format: ir=CDBL(x) 

Bedeutung: Der Wert des numerischen Ausdrucks x wird in eine doppeltge¬ 

naue Zahl gewandelt. 


Beispiel: ok 

X= 12.289 : PRI NT X,CDBLCX) 

12.289 12.28899955749512 

Ok 


Der Wert von CDBL(X) ist nach dem Runden nur bis zur dritten 
Dezimalstelle genau, da X nur mit drei Dezimalstellen definiert 
wurde. Die restlichen Ziffern sind daher ohne Bedeutung. 


Anmerkungen: • Die Typenwandlung bei numerischen Variablen und die 
damit verbundenen Rundungsproblematik ist ausführlich in 
Kapitel 8.5 beschrieben. 
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CHAIN-Anweisung 


Format: CHAIN [MERGE] Dateiangabe{,[Zeile] 

[,[ALL][,DELETE Bereich]]] 

Bedeutung: Es wird ein anderes Amiga Basic-Programm aufgerufen, an das 

Variable aus dem aufrufenden Programm übergeben werden. 

Dateiangabe Zeichenkette in Anführungszeichen (“), wie in 
Kapitel 5.2 angegeben. 

Zeile Konstante oder numerischer Ausdruck zur Angabe einer 
Zeilennummer des aufgerufenen Programms, ab der dieses 
gestartet werden soll. Wird Zeile weggelassen, so wird das 
aufgerufene Programm am Anfang gestartet. Hier darf keine 
alphanumerische Sprungmarke angegeben werden. 

ALL Wird ALL angegeben, so werden alle Variablen des aufru¬ 
fenden an das aufgerufene Programm übergeben. Wird ALL 
nicht angegeben, so muß das aufrufende Programm eine COM- 
MON-Anweisung (s. dort) enthalten, falls Variable übergeben 
werden sollen. 

MERGE Wird MERGE angegeben, so wird das aufrufende 
durch das aufgerufene Programm von der angegebenen Zeile an 
überlagert. Das aufgerufene Programm muß eine Datei im 
ASCII-Format (s.a. MERGE-Befehl) sein. 

DELETE Diese Erweiterung kann nur in Verbindung mit MER¬ 
GE angegeben werden und löscht nach der Ausführung der 
aufgerufenen Überlagerung den nach DELETE angegebenen 
Zeilenbereich. 

Bereich Zeilenbereich, der Im aufrufenden Programm nach 
Ablauf der Überlagerung gelöscht werden soll. Es können hier 
sowohl Zeilennummern als auch alphanumerische Sprungmar¬ 
ken, getrennt durch einen Bindestrich (-), angegeben werden. 
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Beispiel 1: 


Beispiel 2: 


Beispiel 3: 


Beispiel 4: 


Beispiel 5: 


Anmerkungen: 


CHAIN "DF0:PROGR1” 

Das Programm PROGR1 wird vom internen Diskettenlaufwerk 
geladen und am Anfang gestartet. 

CHAIN ”DF0:PROGR1”, 1000 

Wie Beispiel 1. Die Programmausführung beginnt jedoch erst in 
Zeile 1000. 

CHAIN "DF0:PROGR1",1000,ALL 

Wie Beispiel 2. Es werden jedoch alle Variablen des aufrufenden 
Programms an PROGR1 übergeben. 

CHAIN MERGE "DF0: PROGR2" , 100 

Das aufrufende Programm wird durch PROGR2 überlagert. Die 
Überlagerung wird mit Zeile 100 gestartet. 

CHAI N MERGE "DF0: PROGR2” , 100, DELETE 100-3000 

Wie Beispiel 4. Nach der Ausführung der Überlagerung PROGR2 
wird diese jedoch von Zeile 100 bis 3000 gelöscht. 

• Bereits im aufrufenden Programm eröffnete Dateien blei¬ 
ben nach Ausführung der CHAIN-Anweisung geöffnet. 

• Ein mit OPTION BASE (s. dort) gesetzter Wert bleibt nach 
Ausführung einer CHAIN MERGE-Anweisung erhalten. 

• Mit DEF FN oder DEFTyp umdefinierte Variablen müssen 
bei CHAIN MERGE im aufgerufenen Programm auf ihren 
alten Status aus dem aufrufenden Programm gesetzt wer¬ 
den, falls gemeinsame Variablen oder definierte Funktionen 
verwendet werden. 

• Vor der Ausführung eines mit CHAIN geladenen Pro¬ 
gramms wird die RESTORE-Anweisung (s. dort) automa¬ 
tisch ausgeführt, so daß die nächste READ-Anweisung (s. 
dort) auf die erste DATA-Zeile des nach der CHAIN-Anwei¬ 
sung im Hauptspeicher befindlichen Amiga-Basic-Pro- 
gramms zugreift. 

• Wird MERGE zusammen mit DELETE verwendet, so sollten 
anwenderspezifische Funktionen vor dem zu löschenden 
Programmbereich definiert werden. Andernfalls sind sie 
nach dem Löschen Undefiniert. 
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CHDIR 

Format: 

Bedeutung: 


Beispiele: 


Beispiel 1: 

Beispiel 2: 

Beispiel 3: 


Befehl 


CHDIR Pfad 

Ein anderes als das aktuelle Disk- (Disketten- oder Festplat¬ 
ten-) Verzeichnis wird aktualisiert (s.a. Kapitel 1.3.3 im Amiga- 
DOS-Benutzerhandbuch). 

Pfad Eine Zeichenkette in Anführungszeichen (“), die angibt, 
wie ein in dieser Zeichenkette spezifiziertes Verzeichnis erreicht 
wird (s.a. Kapitel 5.2). 

Bei den folgenden Beispielen wird von der unten dargestellten 
Verzeichnisstruktur ausgegangen: 


Basis 



VERWALTUNG LAGER 



PERSONAL MOTOREN KLEINTEILE 



URLAUB KRANK 

CHDIR”:” 

Das Basis-Verzeichnis (root) wird aktuelles Disk-Verzeichnis. 

CHDI R"VERWALTUNG/PERSOHAL/URLAUB” 

Das Verzeichnis URLAUB wird anstelle des Basis-Verzeichnis¬ 
ses aktuelles Verzeichnis. 

CHDIR "KLEINTEILE” 

Das Verzeichnis “KLEINTEILE“ wird anstelle des Verzeichnisses 
LAGER zum aktuellen Verzeichnis. 
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Beispiel 4: chdir " 

Das Verzeichnis VERWALTUNG wird aktuelles Verzeichnis, falls 
PERSONAL vorher aktuelles Verzeichnis war. Ein Verzeichnisna¬ 
me in Form eines Schrägstriches (“/“) kennzeichnet immer das 
hierarchisch nächsthöhere Verzeichnis. 

Beispiel 5: chdir "ueruialtung" 

CHDIR"DFl:LAGER" 

Das Verzeichnis VERWALTUNG wird anstelle des Basis-Ver¬ 
zeichnisses zum aktuellen Verzeichnis auf dem aktuellen Disk- 
Laufwerk (hier DFO:). LAGER wird zum aktuellen Verzeichnis auf 
Disk-Laufwerk DFl:, auf dem es auch vorhanden sein muß. 
Dateiangaben für diese Laufwerke beziehen sich dann automa¬ 
tisch auf in diesen Verzeichnissen enthaltene Dateien. 



9-36 


Befehle, Anweisungen und Funktionen 


CHR$- 

Format: 

Bedeutung: 

Beispiele: 


Funktion 


v$= CHR$(/>) 

Es wird eine Ein-Zeichenkette übergeben, die aus dem Zeichen 
besteht, dessen ASCII-Code (s. Anhang A) durch den Wert des 
ganzzahligen Ausdrucks n gegeben ist. 

n Ein ganzzahliger Ausdruck im Bereich zwischen 0 und 255. 

PRIMT CHR$(7) 

Es wird ein kurzer Ton über den Lautsprecher ausgegeben (s.a. 
BEEP-Anweisung). 

PRINT CHR$(12) 

Das Ausgabefenster wird gelöscht und der Cursor wird in die 
linke obere Fensterecke (Home-Position) gesetzt. 

CLS 

FOR 1=65 TO 90 

PRINT CHR$( I )" 

NEXT 


Es werden die Großbuchstaben des Alphabets angezeigt. 
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CINT-Funktion 


Format: ir=CINT(x) 

Bedeutung: Es wird eine ganze Zahl übergeben, die sich durch Runden des 

Absolutwertes des numerischen Ausdrucks 
x ergibt. 

x Beliebiger numerischer Ausdruck, dessen Wert zwischen 
-32768 und 32767 liegen muß. 

Beispiel 1: ok 

PRINT CINTC1Z.51) 

13 

Ok 

Beispiel 2: ok 

PRINT CINTC 12.5)CINTC 13.5) 

12 14 
Ok 

Beispiel 3: ok 

PRINT CINTC-14.8) 

-15 

Ok 

Anmerkungen: • Liegt der Wert von x außerhalb des erlaubten Bereiches, 
wird der Fehler 

OverfIow 

(Überlauf) angezeigt. 

• Ist der ganzzahlige Teil des numerischen Ausdruckes gera¬ 
de, so rundet CINT ab, ist er ungerade, so rundet CINT auf 
(s. Beispiel 2). 

• Siehe auch bei den Funktionen FIX und INT. 
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CIRCLE-Anweisung 


Format: CIRCLE [STEP] (x,y),r[,Farbe[,Start,Ende 

[,BHd\]\ 

Bedeutung: Es wird eine Ellipse mit dem Mittelpunkt (x,y) und dem Radius r 

auf dem Bildschirm gezeichnet. 

x,y Die absoluten oder relativen (mit STEP) Bildschirmkoordina¬ 
ten des Mittelpunktes der Ellipse. 

r Ein ganzzahliger Ausdruck, dessen Wert den Radius (Haupt¬ 
achse), gemessen in Bildpunkten in horizontaler Richtung, an¬ 
gibt. 

Farbe Eine Farbnummer zwischen 0 und 3 entsprechend der 
mit einer PALETTE-Anweisung (s. dort) gesetzten Farbkennung. 
Voreingestellt ist die Vordergrundfarbe, die mit der COLOR- 
Anweisung (s. dort) eingestellt wurde. 

Start,Ende Numerische Ausdrücke, deren Werte Winkelanga¬ 
ben im Bogenmaß darstellen und die angeben, wo das Zeichnen 
der Ellipse beginnen und enden soll. Die Winkel werden getreu 
der mathematischen Konvention von 0 nach links gezählt und 
können im Bereich zwischen-2‘PI und 2*PI angegeben werden. 

Bild Ein numerischer Ausdruck, dessen Wert das Verhältnis 
von Breite zu Höhe eines Bildpunktes (Bildverhältnis) definiert. 
Das Bildverhältnis ist bei unterschiedlichen Monitortypen ver¬ 
schieden. Wenn in der CIRCLE-Anweisung hier das Bildverhält¬ 
nis des verwendeten Monitors angegeben wird, wird ein exakter 
Kreis, andernfalls eines Ellipse gzeichnet. 

Das Bildverhältnis für den Standard-Amiga-Monitor bei hoher 
Auflösung im 640x200-Bildschirm beträgt 2.25:1 oder etwa 0.44. 
Dieser Wert ist für Bild voreingestellt. 
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Beispiel: buerh= . 1 

WH ILE BOERH<20 

CIRCLE (60,60>,55, 1, , , BUERH 
BUERH = BUERH**1.4 

WEND 

Dieses Beispiel zeichnet um einen Mittelpunkt eine Reihe von 
weißen (falls nicht durch PALETTE-Anweisung geändert) Ellip¬ 
sen, deren Haupt- und Nebenachsen wegen des variierten 
Bildverhältnisses ebenfalls variieren. 
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CLEAR 

Format: 

Bedeutung: 


Beispiel 1: 

Beispiel 2: 

Beispiel 3: 

Beispiel 4: 


Befehl 


CLEAR [,[Prg][,Stapft 

Die Inhalte aller Variablen werden durch Nullsetzen oder Zuwei¬ 
sen von Zeichenketten der Länge Null (Leerstrings) gelöscht. 
Ggf. wird die Obergrenze des für den Interpreter verfügbaren 
Programm- und Stapelspeichers definiert. 

Prg Numerischer Ausdruck, dessen Wert zwischen 1024 und 
dem Oberwert des verfügbaren Systemspeichers liegen muß 
und der den für den Interpreter verfügbaren Basic-Programm- 
speicher dimensioniert. 

Stap Numerischer Ausdruck, dessen Wert zwischen 1024 und 
dem Oberwert des verfügbaren Systemspeichers liegen muß 
und der den für den Interpreter verfügbaren Basic-Stapelspei- 
cher dimensioniert. 

CLERR 

Die Inhalte aller Variablen werden gelöscht. 

CLERR ,40000 


Wie Beispiel 1. Außerdem werden dem Interpreter 40000 Bytes 
als verfügbarer Programmspeicher reserviert. 

CLERR,.1024 

Wie Beispiel 1. Außerdem werden dem Interpreter 1 KBytes als 
Stapelspeicher reserviert. 

CLEAR ,40000,1024 


Faßt Beispiele 2 und 3 zusammen. 
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Anmerkungen: • Voreingestellte Werte für Prg und Stap sind 25000 bzw. 
4789 


• Prg wird heraufgesetzt, wenn für Amiga Basic ein größeres 
Datensegment benötigt wird. 

• Stap wird heraufgesetzt, wenn das Programm viele tiefge¬ 
schachtelte Schleifen (FOR.. .NEXT) oder Subroutinenauf¬ 
rufe (GOSUB) enthält. 

• Neben allen Variablen werden durch CLEAR alle mit DEF- 
Anweisungen vereinbarten Definitionen zurückgesetzt. 

• Alle geöffneten Dateien werden geschlossen, und zugewie¬ 
sene Puffer werden freigegeben. 

• Siehe auch FRE-Funktion. 
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CLNG-Funktion 


Format: ir=CLNG(x) 

Bedeutung: Es wird eine lange Ganzzahl übergeben, die sich durch Runden 

des Absolutwertes des numerischen Ausdrucks 
jr ergibt. 

x Beliebiger numerischer Ausdruck, dessen Wert zwischen 
-2147483648 und 2147483647 liegen muß. 


Beispiel 1: ok 

PRINT CLNGC 33255.56) 

33256 

Ok 


Beispiel 2: ok 

PRINT CLNGC18051964.5)CLNGC12061347.85) 
18051964 12061348 
Ok 


Beispiel 3: ok 

PRINT CLNGC -34589.7 ) 

-34590 

Ok 


Anmerkungen: • Liegt der Wert von x außerhalb des erlaubten Bereiches, 
wird der Fehler 


Overflow 


(Überlauf) angezeigt. 

• Ist der ganzzahlige Teil des numerischen Ausdruckes gera¬ 
de, so rundet CLNG ab, ist er ungerade, so rundet CLNG 
auf (s. Beispiel 2). 
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CLOSE 

Format: 

Bedeutung: 

Beispiel 1: 

Beispiel 2: 

Anmerkungen: 


Anweisung 


CLOSE [[#] Dateinr[,[#] Da feint ]...] 

Die Ein- oder Ausgabe von bzw. an Ein-/Ausgabegeräte wird 
beendet. 

Dateinr Die in der OPEN-Anweisung (s. dort) angegebene 
logische Dateinummer. 

CLOSE ttl,»2,«3 

Die Ein-/Ausgabe von bzw. an die Geräte oder Dateien, für die 
ein Ein- oder Ausgabekanal und damit -Puffer unter den Num¬ 
mern 1, 2 und 3 eingerichtet wurde, wird beendet, und die ggf. 
zugehörigen Dateien werden geschlossen. 

CLOSE 

Alle Ein-/Ausgabedateien oder-kanäle werden geschlossen. 

• Die CLOSE-Anweisung übergibt an die spezifizierten Da¬ 
teien oder Geräte für sequentielle Ausgabe vor dem Schlie¬ 
ßen der Datei den Inhalt des letzten Datenpuffers. 

• Die einer Datei oder einem Ausgabekanal zugeordnete 
Dateinummer wird durch CLOSE wieder frei und kann für 
eine neue OPEN-Anweisung wiederverwendet werden. 

• Die Anweisungen END, NEW, SYSTEM und CLEAR führen 
für alle geöffneten Dateien oder Geräte automatisch CLO¬ 
SE aus. 

• Die Anweisung STOP beinhaltet kein CLOSE. 

• Siehe auch CLEAR, END, NEW, OPEN, STOP, SYSTEM. 
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CLS-Anweisung 

Format: 

CLS 

Bedeutung: 

Das aktuelle Ausgabefenster wird gelöscht und der Cursore wird 
in die obere linke Fensterposition gesetzt. 

Anmerkungen: 

• Es wird nur das aktuelle und kein anderes Ausgabefenster 
durch CLS gelöscht. 
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COLLISION-Anweisung 


Format: COLLISION ON 

COLLISION OFF 
COLLISION STOP 

Bedeutung: Die Unterbrechungsreaktionsfähigkeit für Objekt-Kollisionen 

untereinander oder mit Fensterbegrenzungen wird aktiviert oder 
inaktiviert. 


Beispiel: Siehe OBJECT.SFIAPE-Anweisung für ein ausführliches Bei¬ 

spiel. 


Anmerkungen: • COLLISION ON aktiviert die Unterbrechungsreaktionsfä¬ 
higkeit für Objekt-Kollisionen. In einem Programm prüft der 
Interpreter dann vor jeder neuen Anweisung, ob eine 
Objekt-Kollison stattgefunden hat und verzweigt ggf. zu 
der in der ON COLLISION-Anweisung (s. dort) angegebe¬ 
nen Subroutine. 


• Eine COLLISION-Anweisung darf nicht vor einer ON COL¬ 
LISION-Anweisung im Programm stehen. 

• COLLISION OFF inaktiviert die Unterbrechungsreaktions¬ 
fähigkeit. Unterbrechungen durch Objekt-Kollisionen sind 
nach dieser Anweisung dann nicht mehr möglich. 

• COLLSISION STOP inaktiviert zunächst auch die Unterbre¬ 
chungsreaktionsfähigkeit. Die Unterbrechung bei einer Ob¬ 
jekt-Kollision erfolgt jedoch sofort, sobald die Anweisung 
COLLISION ON ausgeführt wird. 

• S.a. COLLISION-Funktion sowie Kapitel 6.4 “Verarbeitung 
von Unterbrechungsereignissen“. 
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COLLISION-Funktion 


Format: ir= COLLISION (n) 

Bedeutung: Liefert abhängig von der Objekt-Kennung n einen Parameter, 

der die Aussage über verschiedene Parameter eines bewegli¬ 
chen Objektes (Sprite oder Bob) erlaubt. 

n Ein ganzzahliger Ausdruck, dessen Wert entweder eine 
Objekt-Kennung angibt, die mit der Objekt-Kennung in einer 
OBJECT.SHAPE-Anweisung (s. dort) korrespondiert (n> 0) 
oder der die Arbeitsweise der COLLISION-Funktion steuert 
(n =0 oder /i = -1): 

n=0 

COLLISION(O) liefert die Kennummer des Objektes, das 
zuletzt mit einem anderen Objekt kollidiert ist. Der Inhalt 
der Kollisions-Warteschlange, in der alle Kollisionsereig¬ 
nisse zeitlich aufeinanderfolgend gespeichert sind, wird 
dabei nicht verändert. 

n=-1 

COLLISION(-I) liefert die Kennummer des Fensters, in 
dem die durch COLLISION(O) identifizierte Kollision statt¬ 
gefunden hat. 

n< > 0 

Mit einem Parameter ungleich Null liefert diese Funktion die 
Kennung des Objektes, das mit dem Objekt n kollidiert ist 
und entfernt gleichzeitig die Information aus der Kollisions¬ 
warteschlange. 

Liefert die COLLISION-Funktion einen Wert zwischen -1 und -4, 
so bedeutet dies, daß Objekt n mit einer der vier Fensterbegren¬ 
zungen kollidiert ist: 

-1 obere Begrenzung 


-2 linke Begrenzung 
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-3 untere Begrenzung 
-4 rechte Begrenzung 


Beispiel: 


Siehe OBJECT.SHAPE-Anweisung für ein ausführliches Bei¬ 
spiel. 
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COLOR 

Format: 

Bedeutung: 


Beispiel: 

Anmerkungen: 


■Anweisung 


COLOR [Vordergrund\[,Hintergrund] 

Setzt die Vordergrund- und Hintergrundfarben, die Amiga Basic 
für Text-und grafische Anzeigen auf dem Bildschirm benutzt. 

Vordergrund Ein ganzzahliger Ausdruck, dessen Wert zwi¬ 
schen 0 und 3 liegen muß, und der der Farbkennung in der 
letzten PALETTE-Anweisung (s. dort) entspricht. Dieser Wert 
legt die Vordergrundfarbe für die Anzeige von Text oder grafi¬ 
schen Objekten fest. 

Hintergrund Ein ganzzahliger Ausdruck, dessen Wert zwischen 
0 und 3 liegen muß, und der der Farbkennung in der letzten 
PALETTE-Anweisung (s. dort) entspricht. Dieser Wert legt die 
Hintergrundfarbe fest, auf der Text oder grafische Objekte 
angezeigt werden. 

Wird einer der Parameter oder werden beide weggelassen, so 
werden, falls nicht anders durch eine PALETTE-Anweisung 
festgelegt, die voreingestellten Systemfarben weiß für den Vor¬ 
dergrund und blau für den Hintergrund gesetzt. 

PALETTE 1,UND,UND,BND 
PALETTE 2, BND, BND, BND 
COLOB 1, 2 

Bei diesem Beispiel werden für Vordergrund- und Hintergrund 
zufällige Farbmischungen erzeugt, die dann gesetzt werden. 

• Amiga Basic verwendet generell die Standard-Systemfar¬ 
ben weiß für Vordergrund und blau für Hintergrund, falls 
nichts anderes mit der PALETTE-Anweisung (s. dort) fest¬ 
gelegt wird. Die Systemfarben können außerdem vom An¬ 
wender mit dem Voreinsteller-Programm Pereferences (s. 
Amiga-Benutzerhandbuch) festgelegt werden. 
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COMMON-Anweisung 


Format: COMMON Variable{,Variable]... 

Bedeutung: Die in der Anweisung angegebenen Variablen werden an ein mit 

der CHAIN-Anweisung (s. dort) aufgerufenes Amiga Basic-Pro- 
gramm übergeben. 

Variable Name der zu übergebenden Variablen. Feldvariablen 
werden durch () hinter dem Namen gekennzeichnet. 

Beispiel: comoHX,v,zo,x$,Y$o 

CHAIN "DFlIPROGl" 

Das Programm PROG1 wird von Laufwerk DF1: geladen und 
bekommt vom aufrufenden Programm die Variablen X,Y, und X$ 
sowie die Feldvariablen Z und Y$ übergeben. 

Anmerkungen: • Übergebene Feldvariablen brauchen im aufgerufenen Pro¬ 
gramm nicht dimensioniert zu werden. 

• Es sind beliebig viele COMMON-Anweisungen im aufrufen¬ 
den Programm erlaubt, die an beliebiger Stelle stehen 
dürfen. Es empfiehlt sich jedoch, COMMON-Anweisungen 
an den Programmanfang zu stellen, um zu verhindern, daß 
die Programmsteuerung an ein anderes Programm über¬ 
geben wird, bevor durch Ausführen der COMMON-Anwei¬ 
sung die zu übergebenden Variablen definiert wurden. 

• Ein Variablenname darf nicht mehrmals in mehreren COM¬ 
MON-Anweisungen Vorkommen. 

• Sollen alle Variablen übergeben werden, so wird COMMON 
weggelassen und die CHAIN-Anweisung mit dem Zusatz 
ALL verwendet. 
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CONT-Befehl 


Format: CONT 


Bedeutung: Ein durch einen Fehler, durch gleichzeitiges Drücken der Tasten 

AMIGA-. oder durch die Anweisungen STOP oder END abgebro¬ 
chenes bzw. beendetes Programm wird am Unterbrechungs¬ 
oder Beendigungspunkt fortgesetzt, es sei denn, es wurde 
während der Unterbrechung verändert. 

Beispiel: input a.b.c 

K=R«5:L=B*3:PRINTL 
STOP 

M=C*K+1BB:PRINTM 


Wird dieses Beispiel mit RUN gestartet, so ergibt sich im 
Ausgabefenster folgende Anzeige, wenn drei Werte und zwi¬ 
schendurch CONT eingegeben werden: 

? 1,2, 3 
6 

Ok 

cnnt 

115 

Ok 


Anmerkungen: • Wird das Programm bei der Aufforderung zur Dateneingabe 
mit der INPUT- oder der LINE INPUT-Anweisung abgebro¬ 
chen, so setzt CONT das Programm mit der Wiederholung 
dieser Anweisung fort. In allen anderen Fällen wird mit der 
auf die abgebrochene Anweisung folgenden Anweisung 
fortgesetzt. 

• CONT in Verbindung mit STOP erlaubt das schrittweise 
, Austesten von Programmen (s.a. TRON- und TROFF-Be- 
fehle). 
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COS-Funktion 


Format: v=COS(x) 

Bedeutung: Es wird der Cosinus des Wertes des numerischen Ausdruckes x 

berechnet und übergeben. Ist das Argument einfach genau, 

erfolgt die Berechnung einfach-genau, ist es doppelt-genau, so 
wird auch ein doppelt-genauer Wert übergeben. 

x Winkel im Bogenmaß. 

Beispiel: pi=3 .141593 

UINKEL-18B 

RADIONS=UINKEL»P1/180 
PRINT COS(RADIPINS) 

Wird dieses Programm gestartet so ergibt sich die Anzeige 

-1 

Ok 

Um den Cosinus des Winkels von 180 Grad zu ermitteln, wird der 
Winkel in der dritten Programmzeile ins Bogenmaß umgerech¬ 
net. 
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CSNG-Funktion 


Format: ir=CSNG(x) 

Bedeutung: Der Wert des numerischen Ausdrucks xwird in eine einfachge¬ 

naue Zahl umgewandelt. 

Beispiel: ok 

X#=12.34210014343262: PRINT X4t, CSNG( Xtt > 

12.34210014343262 
12.3421 
Ok 

Anmerkungen: • Die Typenwandlung bei numerischen Variablen und die 
damit verbundene Rundungsproblematik ist ausführlich in 
Kapitel 8.5 beschrieben. 


• S.a. CDBL- und CINT-Funktionen. 
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CSRLIN-Systemvariable 


Format: ir=CSRLIN 

Bedeutung: Es wird die Nummer der Bildschirmzeile übergeben, in der der 

Cursor in dem aktuellen Ausgabefenster steht. Die Nummer ist 
immer größer oder gleich 1. 

Beispiel: x=pos< 0 ):y=csrlin 

LOCATE 12, 38: PRINT "Hallo !” 

LOCATE Y, X 

Nachdem zunächst die aktuelle Cursor-Position zwischenge¬ 
speichert wurde, wird derText Hallo! in Schirmzeile 12 ab Spalte 
38 im aktuellen Ausgabefenster geschrieben und dann die alte 
Cursorposition wiederhergestellt. 

Anmerkungen: • Weitere Cursor-bezogene Anweisungen oder Funktionen 

sind LOCATE und POS (s. dort). 
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CVI-, CVL-, CVS-, CVD-Funktionen 


Formate: v= CM\(2-Byte-Zeichenkette) 

v= C\IS(4-Byte-Zeichenkette ) 
v= CVL{4-Byte-Zeichenkette) 
v= C\ID(8-Byte-Zeichenkette) 

Bedeutung: Der Inhalt von Zeichenkette wird als Zahl in interner Darstellung 

interpretiert und in Form eines numerischen Wertes übergeben. 
CVI übergibt eine 2-Byte-Zeichenkette als kurze Ganzzahl. 
CVL übergibt eine 4-Byte-Zeichenkette als lange Ganzzahl. 
CVS übergibt eine 4-Byte-Zeichenkette als einfachgenaue Zahl. 
CVD übergibt eine 8-Byte-Zeichenkette als doppeltgenaue Zahl. 


Beispiel: fiei.d #z,8 ns x$, 10 ns y$ 

get #2 

ZJt=CUD(X$) 


Aus einer Datei für wahlfreien Zugriff mit in der ersten Zeile 
definierten Datenfeldern wird in der zweiten Zeile der nächste 
Datensatz gelesen. In der letzten Zeile des Beispiels werden die 
ersten 8 Bytes als Zahl doppelter Genauigkeit interpretiert und 
der Variablen Z# zugewiesen. 


Anmerkungen: • Numerische Werte werden in Dateien für wahlfreien Zugriff 
grundsätzlich als Zeichenketten (s. MKI$-, MKL$- 
MKS$-, MKD$-Funktionen) gespeichert und müssen nach 
dem Auslesen als numerische Werte zurückgegeben wer¬ 
den. 

• Der Unterschied zur VAL-Funktion (s. dort) besteht darin, 
daß die aktuellen Datenbytes nicht verändert werden. Sie 
werden nur anders interpretiert. 
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DATA-Anweisung 


Format: DATA Konstante],Konstante]... 

Bedeutung: Es werden Konstanten (Zahlen oder Zeichenketten) im Speicher 

abgelegt, die mit der READ-Anweisung (s. dort) im Programm 
gelesen werden können. Es dürfen keine Ausdrücke oder Varia¬ 
blen angegeben werden. 

Konstante Jede numerische oder Zeichenkettenkonstante ist 
erlaubt. Bei numerischen Konstanten ist jeder Typ (s. Kapitel 8.4) 
erlaubt. Enthalten Zeichenkettenkonstanten Kommata (,), Dop¬ 
pelpunkte (:) oder signifikante führende oder nachfolgende 
Leerstellen, so müssen sie in Anführungszeichen (“) einge¬ 
schlossen werden. 

Beispiel: DATA "Das ","Uetter "»"ist "»" schön ! " 

FOB 1 = 1 to 4 

RERD PRINT A$; 

NEXT:PRINT 

Wird dieses Programm gestartet, so ergibt sich folgende Anzei¬ 
ge im Ausgabefenster: 

Das Wetter ist schon! 

Ok 

Anmerkungen: • Die Anzahl der DATA-Anweisungen in einem Programm ist 
nur durch den verfügbaren Speicher begrenzt. 

• Die DATA-Anweisung ist eine nichtausführbare Anwei¬ 
sung. 

• Eine DATA-Anweisung kann so viele Konstanten enthalten, 
wie in eine logische Programmzeile passen. 

• Alle DATA-Anweisungen eines Programms stellen eine 
kontinuierliche Liste von Daten dar, unabhängig davon, 
wieviele andere Programmzeilen zwischen einzelnen DA- 
TA-Zeilen liegen. 
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• Der in der READ-Anweisung deklarierte Variablentyp muß 
mit dem zu lesenden Konstantentyp übereinstimmen, 
sonst wird die Fehlermeldung 

Syntax error 

(Syntaxfehler) angezeigt. 

• Einzelne DATA-Zeilen können mit der RESTORE-Anwei- 
sung (s. dort) wiederholt gelesen werden. 

• Mit der READ-Anweisung werden die DATA-Zeilen in 
aufsteigender Zeilennummernfolge gelesen. 
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DATES- 

Format: 

Bedeutung: 

Beispiel: 

Anmerkungen 


Systemvariable 


ir$= DATE$ 

Es wird eine 10 Zeichen lange Zeichenkette des Formats 
mm-tt-jjjj als Datum einer Zeichenkettenvariablen zugeordnet. 
Das Datum kann vorher mit Hilfe des Voreinsteller-Programmes 
Preferences (s. Amiga-Benutzerhandbuch) gesetzt werden. 

Ok 

PRINT DATE$ 

03-05-1986 

• Das Datum wird grundsätzlich in der angloamerikanischen 
Schreibweise (erst der Monat, dann der Tag, dann das Jahr) 
übergeben. 



9-58 Befehle, Anweisungen und Funktionen 

DECLARE FUNCTION-Anweisung 


Format: DECLARE FUNCTION Name [( Parameterliste )] LIBRARY 

Bedeutung: Deklariert eine Maschinensprache-Routine aus einer Bibliothek 

als eine aufrufbare Funktion und definiert ggf. den Typ des 
Wertes, den die Funktion zurückgibt. 

Name ist jeder gültige Name für eine numerische Amiga Basic- 
Variable, der optional eine der Kennungen %, &, ! oder # 
angefügt werden kann. Dieser Name bezeichnet die Maschinen¬ 
spracheroutine und den Typ des Wertes, der ggf. von dieser 
zurückgegeben wird. 

Parameterliste ist die Liste der Parameter, die die Routine bei 
ihrem Aufruf erwartet. Diese Liste wird von Amiga Basic igno¬ 
riert. Für dokumentarische Zwecke sollte sie jedoch stets ange¬ 
geben werden. 

Beispiel: DECLORE FUNCTION UieuPortnddresst« ) LIBRARV 

LIBRARY "intuition. I ibrary” 
VPfla=UiewPortflddressÄ(WINDOWC7)) 

Bei diesem Beispiel wird der Variaben VPA& der Wert zugewie¬ 
sen, den die Bibliotheksroutine ViewPortAddress& zurückgibt. 

Anmerkungen: • Wenn die Bibliotheksfunktion aufgerufen wird (s. CALL- 
Anweisung), übergibt Amiga Basic alle Parameter, falls 
vorhanden. Die ggf. dem Funktionsnamen in der DECLARE 
FUNCTION-Anweisung angehängte Kennung bestimmt 
den Typ des zurückgegebenen Wertes. Ist keine Kennung 
angefügt, werden die Standardregeln für die Typkennung 
angewendet (s. DEFTyp-Anweisungen). 

• Bei der CALL-Anweisung werden detailliert die Parameter¬ 
übergabe-Konventionen beschrieben. 


• S.a. CSNG, DEFINT, DEFSNG, LIBRARY, CALL. 
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DEF FN 

Format: 

Bedeutung: 


Beispiel: 


Anmerkungen: 


■Anweisung 


DEF FHName{(Ar<fr,Arg\.. .)]= Funktionsdefinition 

Es wird eine vom Anwender festgelegte Funktion definiert und 
benannt. 

Name Ein gültiger Variablenname, der als Funktionsname dient 
und ohne Leerstelle hinter FN angegeben werden muß. 

Arg Ein Variablenname, der beim Aufruf der Funktion durch die 
dann aktuelle Variable oder den aktuellen Wert ersetzt wird. 

Funktionsdefinition Die Rechenvorschrift zur Berechnung des 
Funktionswertes. Die Funktionsdefinition darf ein numerischer 
oder Zeichenkettenausdruck sein, muß aber im Typ mit dem Typ 
von Name übereinstimmen. 

DEF FNRE(X,Y)=X*Y 

PRINT ''Rechteckfläche ist"FNRE(5,4) 

Wird dieses Beispiel mit RUN gestartet, so ergibt dies im 
Ausgabefenster: 


Rechteckfläche ist 20 

Ok 

ln diesem Beispiel wird eine Funktion zur Rechteckflächenbe¬ 
rechnung mit zwei Argumenten definiert. 

• In einer Funktionsdefinition kann nur eine Rechenvorschrift 
angegeben werden. 

• Die angegebenen Argumente dienen nur als Platzhalter und 
haben keinen Einfluß auf Programmvariable gleichen Na¬ 
mens. 

• Ist ein in der Rechenvorschrift angegebener Variablenname 
auch Bestandteil der Argumentliste, so wird beim Funkti¬ 
onsaufruf der Argumentwert mitgegeben; andernfalls der 
aktuelle Wert der Variablen. 
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• Bei numerischen Funktionen wird der Wert des Ausdrucks 
in die durch den Funktionsnamen festgelegte Genauigkeit 
gewandelt, ehe er übergeben wird. 

• Bei fehlender Typübereinstimmung zwischen Name und 
Funktionsdefinition wird die Fehlermeldung 

Type m i smatch 

(keine Typübereinstimmung) angezeigt. 

• Beim Aufruf einer Funktion vor ihrer Definition wird die 
Fehlermeldung 

Undefined user Function 

(Undefinierte Benutzerfunktion) angezeigt. 

• Sich selbst aufrufende (rekursive) Funktionen führen bei 
endloser (fehlerhafter) Rekursion zur Fehlermeldung 

Out oF mcmory 

(Hauptspeicher nicht ausreichend). 

• Wenn mehrere Funktionsdefinitionen unter demselben Na¬ 
men angegeben werden, wird die letzte Definition als die 
aktuelle angesehen. 
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DEF 7yp-Anweisungen 


Format: DEF Typ Buchs^-Buchst\[, BuchsQ-Buchst\]... 

Bedeutung: Es werden Variablentypen als 

• kurze Ganzzahl 

• lange Ganzzahl 

• mit einfacher Genauigkeit 

• mit doppelter Genauigkeit 

• Zeichenkette 

definiert. 


Typ Kennung 

INT = kurze Ganzzahl % 

LNG = lange Ganzzahl & 

SNG = einfache Genauigkeit I 

DBL = doppelte Genauigkeit # 

STR = Zeichenkette $ 


Buchst Ein Buchstabe des Alphabets. 

Beispiele: definta-i 

Alle Variablen, deren Namen mit den Buchstaben A bis I begin¬ 
nen, werden als kurze Ganzzahlvariablen interpretiert. 

DEFDBLX 

Alle Variablen, deren Namen mit X beginnen, werden als numeri¬ 
sche Gleitpunktvariablen doppelter Genauigkeit interpretiert. 

DEFSTR B,X-Z 

Alle Variablen, deren Namen mit B, X, Y oder Z beginnen, werden 
als Zeichenkettenvariablen interpretiert. 

Anmerkungen: • Wird eine Variable durch eines der Typenkennzeichen %, &, 
!, #, oder $ gekennzeichnet, so hat diese Kennzeichnung 
höhere Priorität als die DEFTyp-Anweisung. 





9-62 


Befehle, Anweisungen und Funktionen 


• DEFTyp-Anweisungen müssen, wenn sie benutzt werden, 
immer vor der ersten Verwendung einer damit definierten 
Variablen im Programm stehen. 

• Fehlen DEF Typ-Anweisungen für numerische Variablen in 
einem Programm, so betrachtet der Interpreter Variablen 
ohne Typkennzeichnung als numerische Variablen einfa¬ 
cher Genauigkeit. 

• DEF Typ-Deklarationen gelten grundsätzlich nur für das 
Programm, in dem sie stehen. Bei Verwendung von CFIAIN 
(s. dort) müssen sie ggf. erneut gesetzt werden. 
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DELETE 

Format: 

Bedeutung: 


Beispiele: 


Anmerkungen: 


Befehl 


DELETE [Marke1][-[Marke2\] 

Der angegebene Zeilennummernbereich wird im Programm ge¬ 
löscht und Amiga Basic kehrt auf die Befehlsebene zurück. 

Markei Nummer oder alphanumerische Sprungmarke der er¬ 
sten zu löschenden Zeile. 

Marke2 Nummer oder alphanumerische Sprungmarke der letz¬ 
ten zu löschenden Zeile. 

DELETE 10 

Zeile 10 wird gelöscht. 

DELETE10-200 

Zeilen 10 bis 200 werden gelöscht. 

DELETE -200 

Alle Zeilen vom Programmanfang bis Zeile 200 einschließlich 
werden gelöscht. 


DELETE Druck — 


Alle Zeilen von einschließlich Druck: bis zum Programmende 
werden gelöscht. 

• Angabe einer nicht existierenden Programmzeile führt zu 
der Fehlermeldung 

I I legrat I Funet ioncal 1 


(unerlaubter Funktionsaufruf) 
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DIM-Anweisung 


Format: DIM [SHAHED] Vat\lnd\[,Vai\lnd)] 

Bedeutung: Es wird die maximale Anzahl von Elementen für Feldvariablen 

beliebigen Typs definiert und entsprechender Speicherplatz 
reserviert. 

Var Name der Feldvariablen. 

Ind Eine Liste numerischer Ausdrücke, deren Werte, durch 
Kommata getrennt, die Anzahl der Elemente je Dimension ange¬ 
ben. 

Mit dem Zusatz SHARED werden die Variablen als globale Felder 
dimensioniert, die damit dem Hauptprogramm und allen Unter¬ 
programmen gleichermaßen zur Verfügung stehen. DIM 
SHARED darf nur im Hauptprogramm angegeben werden. 

Durch DIM werden alle Elemente bei numerischen Feldern auf 
Null und bei Zeichenkettenfeldern auf Länge Null (Leer-Zeichen- 
kette) gesetzt. 

Beispiel 1 : dim a$cz 0 ),bc 8 ,s) 

FOR 1=0 TO 20: READ A$C I D : NEXT 
FOR J=0 TO 8: FOR K=0TO 5 
READ NEXT K, J 

Zunächst werden ein Zeichenkettenfeld mit 21 sowie ein numeri¬ 
sches, zweidimensionales Feld aus 9 Zeilen und 6 Spalten, also 
54 Elementen definiert, die dann in Leseschleifen aus anderwei¬ 
tig deklarierten DATA-Zeilen gefüllt werden. 

Beispiel 2: dim shared a, b, cc 10 , 2 ) 

DIM CFC 19) 

FOR 1 = 1 TO 19 
READ CFC I ) 

PRINT CFC I ) 

NEXT I 

DATA 0, 2, 4, S, 7,9, 11, 0,1, -1,0, 0,0, 0,0, 0,-12, 12, 0 
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Anmerkungen: 


• Mit DIM SHARED können auch einfache Variable als globale 
Variable deklariert werden (s. Beispiel 2). Das erspart ggf. 
separate SHARED-Anweisungen in den jeweiligen Unter¬ 
programmen. 

• Der kleinste Indexwert für ein Feld ist immer Null, es sei 
denn, mit der OPTION BASE-Anweisung (s. dort) wurde 
etwas anderes vereinbart. DIM A(10) reserviert also Platz für 
11 Elemente. 

• Der größte Indexwert für ein Feld ist 32767. 

• Es sind maximal 255 Dimensionen möglich; es ist jedoch die 
Hauptspeicherkapazität zu berücksichtigen. 

• Ohne DIM-Anweisung vereinbart der BASIC-Interpreter bei 
der ersten Verwendung einer Feldvariablen automatisch 
einen größten Indexwert von 10, erlaubt also Felder von 
maximal 11 Elementen ohne Dimensionierung. 

• Verwendung von größeren als dimensionierten Indizes führt 
zu der Fehlermeldung 


Subscript out of ränge 


(Index außerhalb des Bereiches). 

• Mehrmaliges Dimensionieren derselben Feldvariablen führt 
zur Fehlermeldung 


Dup I icate def i n i t ion 


(Doppelte Definition). 
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END-Anweisung 

Format: 

END 

Bedeutung: 

Alle ggf. geöffneten Dateien werden geschlossen, das Pro¬ 
gramm wird beendet, und Amiga Basic kehrt auf die Befehlsebe¬ 
ne (Direkt-Modus) zurück. 

Beispiel: 

Warte : 

Z$=INKEY$ 

I F Z$=”»" THEN END ELSE Warte 

Das Programm wartet auf das Drücken einer Taste und wird nur 
beendet, wenn die ‘-Taste gedrückt wird. 

Anmerkungen: 

• Es können beliebig viele END-Anweisungen an beliebigen 
Stellen im Programm stehen. 

• In einem linearen Programm braucht als letzte auszuführen¬ 
de Anweisung keine END-Anweisung zu stehen. 

• Programme, die mit END beendet wurden, können mit der 
CONT-Anweisung (s. dort) fortgesetzt werden, falls nach 
der END-Anweisung noch weitere Anweisungen folgen. 
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END SUB-Anweisung 


Siehe SUB-Anweisung. 
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EOF-Funktion 


Format: v= EQF(Dateini) 

Bedeutung: Die EOF-Funktion liefert einen logisch “wahren“ Wert (-1), wenn 

bei einer Leseoperation in einer sequentiellen Datei das Dateien¬ 
de erreicht wurde und einen logisch “falschen“ Wert (0), wenn 
noch kein Ende erreicht wurde. 

Dateinr Die Nummer, unter der die Datei mit OPEN eröffnet 
wurde. 

Beispiel: open "i",#3, "Eingabe" 

WHILE NOT EOF(3) 

LINE INPUT #3, AC J) 

J=J+1 
WEND 
CLOSE #3 
END 

Es werden solange numerische Daten aus der sequentiellen 
Eingabedatei EINGABE gelesen und im Feld A abgelegt, bis das 
Dateiende erreicht wird. 

Anmerkungen: • Mit der EOF-Funktion kann die Fehlermeldung 

Iinpu-t past end 

(Eingabe nach logischem Dateiende) vermieden werden. 
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ERASE 

Format: 

Bedeutung: 

Beispiel: 


Anmerkungen 


Anweisung 


ERASE Feldvar[,Feldvar\ 

Es werden die Felder, deren Namen als Parameter in der 
Anweisung angegeben werden, aus dem Programm gelöscht 
und der dafür reservierte Speicherplatz wird wieder freigegeben. 

Feldvar Der Name des zu löschenden Feldes. 

CLE0R .100000 
STORT=FRE(0) 

DIM FELD« 100, 100) 

MITTE=FRE<0) 

ERfiSE FELD 
DIM FELD ( 10, 10) 

ENDE=FRE(0) 

PRINT STÖRT;MITTE; ENDE 

Wird dieses Programm gestartet, so erhält man im Ausgabefen¬ 
ster eine Anzeige wie: 

99984 59145 99450 
Ok 

Nach dem Löschen des sehr groß dimensionierten Feldes FELD 
in der 5. Zeile wird dieses neu dimensioniert. Jeweils vor und 
nach den Dimensionierungen wird die Anzahl der verbleibenden 
Speicherplätze vermerkt und am Ende ausgedruckt. 

• Nachdem ein Feld mit ERASE gelöscht wurde, kann es mit 
DIM neu dimensioniert werden. 
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ERL-Systemvariable 

Format: 

v= ERL 

Bedeutung: 

Es wird die Nummer der Programmzeile übergeben, in der ein 
Fehler aufgetreten ist. Hat die fehlerhafte Zeile keine Zeilennum¬ 
mer, so liefert ERL die Nummer der letzten vor der fehlerhaften 
Zeile numerierten Zeile. ERL liefert nicht den Namen einer 
alphanumerischen Sprungmarke. 

Beispiel: 

200 I F ERL= 100 THEN 1000 

Anmerkungen: 

• Wenn eine fehlerhafte Anweisung im Direktmodus ausge¬ 
führt werden soll, weist der Interpreter der ERL-Variablen 
den Wert 65535 zu. 



Befehle, Anweisungen und Funktionen 


9-71 


ERR-Systemvariable 


Format: p=ERR 


Bedeutung: Der Code des jeweils letzten vom Interpreter diagnostizierten 

Fehlers (s.a. Anhang B) wird der Systemvariablen ERR zugewie¬ 
sen (s.a. ON ERROR-Anweisung). 

Beispiel: ON ERROR GOTO Fehler 


Fehler: IF ERHÖH THEN . . . 
PRINT "Division durch Nu 1 1”: END 


Im Fehlerfall verzweigt das Programm zur Sprungmarke Fehler, 
wo geprüft wird, ob der Fehler durch eine Division durch Null 
verursacht wurde. Falls ja, wird eine Meldung angezeigt und das 
Programm beendet. 
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ERROR 

Format: 

Bedeutung: 


Beispiel: 


■Anweisung 


ERROR n 

Es wird entweder ein Programmfehler simuliert oder es wird ein 
anwender-spezifischer Fehlercode definiert. 

n Wird für n (0 bis 255) ein gültiger Fehlercode (s. Anhang B) 
angegeben, so simuliert ERROR den dadurch definierten Fehler. 
Existiert eine Verzweigung in eine Fehlerroutine (s. ON ER- 
ROR-Anweisung), so wird die Fehlerroutine durchlaufen. An¬ 
dernfalls wird die Fehlermeldung angezeigt, und das Programm 
wird angehalten. Für die Definition eigener Fehlercodes müssen 
für n Werte außerhalb der Fehlerliste von Amiga Basic (s. Anhang 
B) angegeben werden (z.B. über 150). So definierte Fehler 
werden genau wie Standard-Fehlermeldungen verarbeitet. Tritt 
ein selbstdefinierter Fehler auf, und es existiert dafür keine 
Fehlerroutine, so meldet der Interpreter 


Unprintab1e error 


(nicht druckbarer Fehler) und hält das Programm an. 

E=23:ERROR E 

Wird diese Zeile ausgeführt, so wird ein Kommunikationsfenster 
mit der Meldung 


Line Buffer Overflow 


angezeigt. 
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Beispiel 2: 100 oh error goto 1000 

110 I NPUT "Bitte flnf angswert angeben" ; flW 
120 IF fiW< 12 THEN ERROR 150 


1000 IF ERR= 150 THEN PRINT "zu klein" 
1010 IF ERL=120 THEN RESUME 110 
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Wird in Zeile 110 für AW ein kleinerer Wert als 12 eingegeben, so 
führt dies zu einem selbstdefinierten Fehler (Code 150), der in 
Zeile 1000 bearbeitet wird und zur Eingabewiederholung führt. 
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EXIT SUB-Anweisung 


Siehe SUB-Anweisung. 
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EXP-Funktion 


Format: ir=EXP(x) 

Bedeutung: Die EXP-Funktion berechnet den Wert der Exponentialfunktion 

zur Basis e mit dem numerischen Ausdruck xim Exponenten. 

Beispiel: ok 

X=4:PRINT EXPC SQRC X > > 

7.389056 
Ok 

Es wird e hoch Wurzel aus 4, also e zum Quadrat, berechnet. 

Anmerkungen: • Falls ein numerischer Wert größer als 88 bei einfacher 
Genauigkeit sowie 709 bei doppelter Genauigkeit angege¬ 
ben wird, zeigt der Interpreter den Fehler 

Overf 1 oui 


(Überlauf) an. 
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FIELD 


Format: 


Bedeutung: 


Beispiel: 


Anweisung 


FIELD [#]Dateinr,Länge AS Zeikettvar 
[,Länge AS Zeikettvar\... 

Es wird Platz für Variablenwerte in einem Puffer für Dateien mit 
wahlfreiem Zugriff reserviert. 

Dateinr Die Nummer, unter der die Datei für wahlfreien Zugriff 
eröffnet wurde. 

Länge Ein numerischer Ausdruck, dessen Wert die für die 
jeweils mit angegebene Zeichenkettenvariable zu reservierende 
Länge (Zeichenanzahl) angibt. 

Zeikettvar Name einer Zeichenkettenvariablen, der die definier¬ 
te Zahl von Zeichen aus dem Puffer zugewiesen wird (s.a, GET- 
und PUT-Anweisungen für Dateien). 

OPEN "LflGEH" HS #3 LEN= 144 

FIELD #3, Z HS RRTNR$, Z0 HS BEZ$, 2 HS STZ$ 

FOR 1 = 1 TO 100 

LSET nRTNR$=MKI$(nNX(I )) 

LSET BEZ$=BZ$C 1 ) 

LSET STZ$=SZ$< I ) 

PUT #3, I 
NEXT 

Bei diesem Beispiel wird zunächst die Datei LAGER für wahl¬ 
freien Zugriff auf dem aktuellen Laufwerk eröffnet. Dann wird 
jeder logischen Datensatz in 3 Felder unterschiedlicher Länge 
unterteilt, die auch benannt werden. In einer Schleife werden 
dann 100 Sätze in die Datei geschrieben, wobei für jeden Satz die 
Daten aus anderweitig dimensionierten und gefüllten Feldern 
entnommen und vor dem Schreiben in dem Puffer abgelegt 
werden (s.a. Kapitel 5). 


Anmerkungen: • Die FIELD-Anweisung überträgt keine Daten in den Puffer 
(s. dazu LSET- und RSET-Anweisungen). 
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• Die FIELD-Anweisung liest keine Daten aus der Datei, son¬ 
dern unterteilt den Puffer in Felder und ordnet diese den 
angegebenen Variablen zu. 

• Die Summe der für eine Datei in einer FIELD-Anweisung 
definierten Feldlängen darf die durch die OPEN-Anweisung 
festgelegte logische Datensatzlänge nicht überschreiten. 
Andernfalls wird die Meldung 


F ield overflow 


(Feldüberlauf) angezeigt. 

• Unter einer Dateinummer dürfen beliebig viele FIELD-Anwei- 
sungen deklariert werden, die alle gültig sind. Jede neue 
FIELD-Anweisung beginnt aber immer mit der ersten Positi¬ 
on im Puffer. 

• Achtung: Wird eine in einer FIELD-Anweisung definierte 
Variable später im Programm bei einer Zuweisung (z.B. 
A$ = “DATEN“) oder in einer INPUT-Anweisung (z.B. INPUT 
“Bitte Eingabe“ ;A$) verwendet, so ist damit die Zuweisung 
in der Fieldanweisung aufgehoben. 
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FILES-Befehl 


Format: FILES [Dateiangabe} 

Bedeutung: Es wird der Inhalt des aktuellen Diskettenverzeichnisses auf dem 

Bildschirm angezeigt. Der Befehl entspricht dem DIR-Befehl im 
AmigaDOS. 

Dateiangabe Ein Zeichenkettenausdruck wie in Kapitel 5.2 
angegeben. Wird die Dateiangabe im FILES-Befehl weggelas¬ 
sen, so werden alle Dateien des aktuellen Diskettenverzeichnis¬ 
ses angezeigt. 

Beispiel 1: files 

Alle Dateien des aktuellen Diskettenverzeichnisses auf dem 
voreingestellten Laufwerk werden angezeigt. 

Beispiel 2: files "dfi:" 

Alle Dateien im Basis-Verzeichnis auf Laufwerk DFI: werden 
angezeigt. 

Anmerkungen: • Im Kapitel 1.3.3 des AmigaDOS-Benutzerhandbuches sind 
die Datei- und Verzeichnis-Bennungskonventionen ausführ¬ 
lich beschrieben. 
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FIX-Funktion 


Format: 

v= FIX(x) 


Bedeutung: 

Die Dezimalstellen des Wertes des beliebigen numerischen 
Ausdrucks x rechts vom Dezimalpunkt werden ohne Rundung 
abgeschnitten. 


x Ein beliebiger numerischer Ausdruck. 


Beispiele: 

Ok 

PRINT FIXC3.84) 

3 

Ok 

PRINT F1XC-12.85) 

-12 

Ok 

PRINT 1NTC-12.85) 

13 

Ok 


Anmerkungen: 

• Bei negativen Werten wird nicht die nächst 
übergeben (s.a. INT- und CINT-Funktionen). 

kleinere Zahl 
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FOR-. 


Format: 


Bedeutung: 


Beispiel 1: 


. NEXT-Anweisungen 


FOR Var= xTO y [STEP z] 


NEXT [Var\[,Var\ 

Die Kombination dieser beiden Anweisungen erlaubt die Mehr¬ 
fachverarbeitung einer Folge von Befehlen, Anweisungen und/ 
oder Funktionen in einer Schleife mit einer definierten Zahl von 
Durchläufen. 

Var Eine beliebige ganzzahlige oder einfach-genaue Variable, 
die als Schleifendurchlaufzähler dient. 

x Ein numerischer Ausdruck, dessen Wert den Zähleranfangs¬ 
wert festlegt. 

y Ein numerischer Ausdruck, dessen Wert den Zählerendwert 
festlegt. 

z Ein numerischer Ausdruck, dessen Wert die Schrittweite 
festlegt, um die der Durchlaufzähler nach jedem Durchlauf 
erhöht wird. Wird z nicht angegeben, so wird eine Schrittweite 
von 1 angenommen. 


J=12:K=50:L=4 
FOR I = 1 TO J STEP L 
PRINT I ; K+ 1 
NEXT 

ergibt in dem Ausgabefenster 

1 51 
5 55 
9 59 
Ok 

Die Schleife mit einer Schrittweite von 4 wird nur dreimal 
durchlaufen, weil der Schleifenzähler I beim 4. Durchlauf größer 
als der Endwert J würde. 




Befehle, Anweisungen und Funktionen 


9-81 


Beispiel 2: 


Anmerkungen: 


FOR 1 = 1 TO 10 
FOR J=1 TO 3 

READ BCI,J) 

NEXT J, I 

Bei diesem Beispiel wird in einer geschachtelten Schleife das 

Feld B aus anderweitig definierten DATA-Anweisungen gefüllt. 

• Vor der Ausführung der NEXT-Anweisung wird nach der 
Erhöhung des Schleifenzählers um die Schrittweite geprüft, 
ob dieser größer als der vorgegebene Endwert ist. Ist er 
größer, fährt das Programm mit der auf NEXT folgenden 
Anweisung fort; ist er kleiner oder gleich, wird die Schleife 
erneut durchlaufen. 

• Bei negativer Schrittweite muß der Anfangswert größer als 
der Endwert angegeben werden. Die Schleife wird dann 
solange durchlaufen bis der Zähler kleiner als der Anfangs¬ 
wert wird. 

• Ist die Schrittweite 0, so wird die Schleife unendlich oft 
durchlaufen, es sei denn, sie wird durch eine Programmab¬ 
frage (z.B. IF.. .THEN) verlassen. 

• Bei geschachtelten Schleifen muß für jeden Zähler eine 
eigene Variable angegeben werden. Die NEXT-Anweisung 
für eine innere Schleife muß immer vor der NEXT-Anweisung 
der sie umgebenden äußeren Schleife im Programm stehen. 
Die Schreibweise NEXT Var1,Var2,Var3.. . ist ebenso zuläs¬ 
sig wie die Variante NEXT Varl.NEXT Var2:NEXT Var3... 

• Variablenangaben in der NEXT-Anweisung können wegge¬ 
lassen werden. Sie erhöhen jedoch speziell bei mehrfach 
geschachtelten Schleifen die Lesbarkeit des Programms. 

• Fehlen bei einer Schleife die FOR- oder die NEXT-Anwei¬ 
sung, so werden die Fehlermeldungen 

FOR u ithout NEXT 

(FOR ohne NEXT) bzw. 

NEXT u ithout FOR 


(NEXT ohne FOR) ausgegeben. 
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FRE-Funktion 

Format: 

v= FRE(x) 

Bedeutung: 

Die FRE-Funktion liefert je nach Wert des numerischen Argu¬ 
mentes x verschiedene Aussagen über freie Speicherplätze in 
Bytes: 


x=-1 noch verfügbarer Systemspeicher; 

x=-2 noch verfügbarer Amiga Basic-Stapelspeicher; 

*>-1 noch verfügbarer Speicher im Amiga Basic-Daten- 

segment. 

Beispiel: 

PRINT FREC1);FREC-1) 

20350 225400 

Ok 


Der verfügbare Speicherplatz im Amiga Basic-Datensegment, 
also für Basic-Programmtext, beträgt 20350 Bytes, während im 
System noch 225400 Bytes unbenutzt sind. 

Anmerkungen: 

• Ehe mit der CLEAR-Anweisung (s. dort) mehr Basic-Spei- 
cher zugewiesen wird, sollte mit der FRE-Funktion der noch 
verfügbare Systemspeicher überprüft werden. 
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GET-Anweisung für Dateien 


Format: GET [#] Dateinr[,Satznr\ 

Bedeutung: Der logisch nächste oder der angegebene Satz wird aus einer 

Datei für wahlfreien Zugriff (Direktzugriffsdatei) in einen Puffer 
übernommen. 


Dateinr Die Nummer, unter der die Datei in der OPEN-Anwei- 
sung eröffnet wurde. 

Satznr Die Nummer des zu lesenden logischen Datensatzes. 
Die Nummer muß zwischen 1 und 167/7215 liegen, wenn sie 
angegeben wird. Wird sie nicht angegeben, so wird der logisch 
nächste Satz der Datei gelesen. 

Beispiel 1: open "lrger" ns #3 len=144 

FIELD # 3 , 2 ns RRTNR$,ZB PS BEZ$,2 RS STZ$ 

GET 113 

PRINT RRTNR $, STZ$ 


Nach der Eröffnung der Datei LAGER für wahlfreien Zugriff 
werden die einzelnen Felder der zu lesenden Sätze definiert und 
benannt. Anschließend wird der logisch nächste Satz aus der 
Datei in den Puffer gelesen, und 2 Elemente dieses Satzes 
werden ausgedruckt. 

Anmerkungen: • Nachdem GET ausgeführt wurde, können mit INPUT #, LINE 
INPUT # oder einfach durch Bezugnahme auf in der FIELD- 
Anweisung deklarierten Variablen Daten aus dem Dateipuf¬ 
fer übernommen werden (s.a. Kapitel 5.3). 

• Amiga-DOS legt auf Diskette oder Festplatte physikalische 
Sätze (Sektoren) von 512 Bytes Länge an, in die fortlaufend 
die logischen Sätze übertragen werden, so daß bei kürzeren 
Satzlängen mehrere logische Sätze in einen physikalischen 
Satz passen. Deshalb führt eine GET-Anweisung nicht unbe¬ 
dingt zu einem physikalischen Lesen von Disk. 
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GET-Anweisung für Grafik 


Format: GET (x1,y1)-{x2,y2),Feldvar [( lndex{,Index.. ,,lndex\)\ 

Bedeutung: Es werden von einem definierten Bildschirmbereich (Fenster) 

die Bildpunkte gelesen und als binäre Information (bitweise) in 
einem numerischen Feld gespeichert. 

[Xl,y1),(x2,y2) Absolute Koordinaten der oberen linken und 
unteren rechten Ecke des auszulesenden Bereiches. 

Feldvar Eine numerische Feldvariable beliebiger Genauigkeit, 
in der die Bildpunktinformation bitweise abgelegt wird. 

Index Die optionale Angabe von Feldelementen über deren 
Index erlaubt die Speicherung mehrere grafischer Objekte in 
einem mehrdimensionalen Feld. Auf diese Weise können ver¬ 
schiedene Ansichten des Objektes gespeichert und auch 
schnell mit der PUT-Anweisung für Grafik (s. dort) wieder 
dargestellt werden. 

Die Anzahl der erforderlichen Bytes in dem Feld errechnet sich 
aus 

6+ [y2-y1 +1) ‘2* \HT((x2-x1+ 16)/16)* T 

wobei xl.yl bzw. x2,y2 die Koordinaten der linken oberen bzw. 
rechten unteren Ecke des Bildausschnittes bedeuten. Fist die 
Bildschirmtiefe, die mit 2 voreingestellt ist (s. SCREEN-Anwei- 
sung). 

Beispiel: dimax( 2 £) 

get (e,a>-(9,m,nx 

In diesem Beispiel soll ein Bildfenster von 10x12 Punkten in das 
Ganzzahlfeld A% gespeichert werden. Nach der oben beschrie¬ 
benen Formel werden dazu 


6+ (11-0 + 1)*2‘INT((9-0+16)/16)*2 = 54 Bytes 
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benötigt. In einem Ganzzahlfeld werden 2 Bytes pro Element 
reserviert, so daß ein Feld von 27 Elementen (0 bis 26) ausreicht. 

Anmerkungen: • Wenn ein Ganzzahlfeld für die Bildinformation angelegt wird, 
so enthält das Feldelement 0 die Breite, Feldelement 1 die 
Höhe, Feldelement 2 die Tiefe und die anschließenden Ele¬ 
mente die binären grafischen Informationen des rechtecki¬ 
gen Bildausschnittes. In diesem Fall können also die grafi¬ 
schen Daten direkt im Feld interpretiert werden. 

• So gespeicherte Informationen können mit der PUT-Anwei- 
sung für Grafik (s. dort) schnell wieder auf den Bildschirm ge 
bracht werden. 
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GOSUB 


Format: 


Beispiel: 


Anmerkungen: 


und RETURN-Anweisungen 


GOSUB Marke 


RETURN [Weiter\ 

Sprung in eine Subroutine und Rückkehr in das Hauptprogramm 
(s.a. ON,. .GOSUB-Anweisung). 

Marke, Weiter Eine gültige Zeilennummer oder alphanumeri¬ 
sche Sprungmarke, bei der die Subroutine beginnt bzw. bei der 
nach der Rückkehr aus der Subroutine das Hauptprogramm 
fortgeführt werden soll. Wird bei RETURN Wetter nicht angege¬ 
ben, so wird das Hauptprogramm mit der auf die GOSUB-Anwei¬ 
sung folgenden Anweisung fortgesetzt. 


100 PRINT "Dies ist das Hauptprogramm" 

110 GOSUB 140 

120 PRINT "Fortsetzung d. Hauptprogramms" 

130 END 

140 PRINT "Vom Unterprogramm gedruckt*’ 

150 RETURN 

Dieses Programm ergibt im Ausgabfenster folgende Anzeige: 

Dies ist das Hauptprogramm 
Vom Unterprogramm gedruckt 
Fortsetzung d . Hauptprogramms 
Ok 

• Bei Amiga Basic wird zwischen Subroutinen und Unterpro¬ 
grammen unterschieden. Subroutinen sind immer in Amiga 
Basic programmiert, werden ausschließlich mit GOSUB auf¬ 
gerufen und kennen keine lokalen Variablen. Unterprogram¬ 
me können in Amiga Basic oder auch in Maschinensprache 
programmiert sein, kennen lokale und globale Variablen und 
werden mit der CALL-Anweisung (s. dort und Kapitel 6.1) 
aufgerufen. 
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• Es dürfen beliebig viele Aufrufe für eine Subroutine in einem 
Programm Vorkommen. 

• Subroutinen können an beliebiger Stelle im Hauptprogramm 
stehen, sollten jedoch zusammengefaßt werden und vom 
Hauptprogramm durch eine GOTO- oder END-Anweisung 
getrennt werden, damit sie nicht unkontrolliert durchlaufen 
werden. 

• Die Schachtelungstiefe (Aufruf einer Subroutine aus einer 
Subroutine) wird nur durch die Hauptspeicherkapazität be¬ 
grenzt. 

• Die Anweisung RETURN übergibt die Programmsteuerung 
an die Anweisung, die im Hauptprogramm auf die GOSUB- 
Anweisung folgt, oder an die Zeile im Hauptprogramm, deren 
Nummer oder alphanumerische Sprungmarke bei der RE- 
TURN-Anweisung angegeben wurde. 

• Bei der Angabe einer Zeilennummer oder alphanumerischen 
Sprungmarke bei der RETURN-Anweisung ist mit Vorsicht 
vorzugehen, da alle zur Zeit des Subroutinenaufrufes aktiven 
anderen GOSUB-, CALL-, WHILE- und FOR-Anweisungen 
auch hinterher aktiv bleiben, also Bezugsadressen auf dem 
Stapelspeicher hinterlegt haben. 

• Es dürfen beliebig viele RETURN-Anweisungen in einer 
Subroutine stehen. 
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GOTO-Anweisung 


Format: GOTO Marke 


Bedeutung: Unbedingte Programmverzweigung zu einer bestimmten Pro¬ 

grammzeile (s.a. ON.. .GOTO-Anweisung). 

Marke Eine gültige Zeilennummer oder alphanumerische 
Sprungmarke, die die Zeile bezeichnet, bei der das Programm 
fortgesetzt werden soll. 

Beispiel: checkn aus - 

I F MOUSE(0) = 0 THEN CheckMaus 
IF ftBS(X-MOUSE(l))>2 THEN SchiebBi Id 
I F ftBS(V—MOUSEC2) ><3 THEN CheckMaus 
SchiebBi I d : 

PUT (X,V),P 

X=MOUSECl):y=M0USEC2) 

PUT (X» Y)» P 
GOTO CheckMaus 


Ein Beispiel, wie mit Hilfe der GOTO-Anweisung ein kleines 
Programm erstellt werden kann, mit dem ein grafisches Objekt 
mit der Maus bei gedrückter Auswahltaste auf dem Bildschirm 
bewegt werden kann. 

Anmerkungen: • Enthält die hinter GOTO angegebene Zeile nicht ausführbare 
Anweisungen (DATA, REM), so wird das Programm mit der 
nächsten darauf folgenden, ausführbaren Zeile fortgesetzt. 

• Im Direktmodus kann mit GOTO in ein Programm, das im 
Hauptspeicher resident ist, hineinverzweigt werden (z.B. 
zum Testen). 

• Es empfiehlt sich, Programmsteuerstrukturen besser mit 
den Anweisungen IF. . .THEN. . ELSE, WHILE. . .WEND oder 
ON.. .GOTO (s. dort) anstatt mit GOTO aufzubauen, da im 
letzteren Fall die Programme sehr unübersichtlich werden 
und schlecht zu testen sind. 
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HEX$-Funktion 


Format: ir$=HEX$(n) 

Bedeutung: Es wird eine Zeichenkette übergeben, die die hexadezimale 

Darstellung des Wertes des numerischen Ausdrucks n enthält. 

n Beliebiger numerischer Ausdruck, dessen ganzzahliger Wert 
gewandelt wird und der im Bereich zwischen -32768 und 65535 
liegen muß. Bei negativen Werten wird die Zweier-Komple- 
ment-Darstellung benutzt. 

Beispiel: X=23.4:Y=-256 

PRINT X; HEX$(X) ,V;HEX$(Y) 

ergibt im Ausgabefenster die Anzeige 

23.4 17 -256 FF00 

Anmerkungen: • Vor der Wandlung werden ggf. vorhandene Dezimalstellen 
rechts vom Dezimalpunkt abgeschnitten. 

• Die Wandlung in oktale Darstellung kann mit der OCT$- 
Funktion (s. dort) erreicht werden. 
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IF-Anweisung 


Format: 

Syntax 1: IF Ausdr GOTO Marke [ELSE An weis] 

Syntax 2: IF Ausdr THEN Anweis [ELSE Anweis] 

Syntax 3: \f Ausdr Anweis 

ELSEIF Ausdr THEN Anweis 
ELSE Anweis 
END IF 


Bedeutung: Erlaubt die Verzweigung in verschiedene Programmteile oder die 

Ausführung verschiedener Anweisungsblöcke, abhängig vom 
Wahrheitsgehalt eines logisch auswertbaren Ausdruckes. Ein 
solcher Ausdruck ist logisch “wahr“ (s.a. Kapitel 8.6), wenn sein 
Wert von Null verschieden ist, und logisch falsch, wenn sein Wert 
Null ist. 


Ausdr Jeder beliebige Ausdruck, der logisch auswertbar ist. 

Anweis Eine einzelne Anweisung oder ein aus mehreren durch 
Doppelpunkte getrennten Anweisungen zusammengesetzter 
Anweisungsblock oder auch eine gültige Amiga Basic-Zeilen- 
nummer oder alphanumerische Sprungmarke, die die Zeile be¬ 
zeichnet, zu der nach THEN oder ELSE verzweigt werden soll. 

Marke Eine gültige Amiga Basic-Zeilennummer oder alphanu¬ 
merische Sprungmarke, die die Zeile bezeichnet, zu der ver¬ 
zweigt werden soll. 
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Beispiel: 


Anmerkungen: 


INPUT a, b 
IF a=lTHEN 

IF b=l THEN 

PRINT "ä= 1 und b=l° 

ELSE 

PRINT "*=1, bol” 

END IF 

ELSEIF a>0 THEN 

IF b>0 THEN PRINT "a>0 und b>0" 

REM ***** obige Zeile ist keine B lock — I F-flnwe isung 
PRINT ”a>0" 

ELSE 

PRINT "a<=0" 

PRINT "über b ist nichts bekannt” 

END IF 

Folgende Regeln gelten für alle 3 Formen der IF-Anweisung: 

• Ist das Ergebnis von Ausdr logisch “wahr“, wird GOTO oder 
Anwels hinter THEN ausgeführt. 

• Ist das Ergebnis von Ausdr logisch falsch, wird GOTO oder 
Anweis hinter THEN ignoriert und stattdessen Anweis hinter 
ELSE, falls vorhanden, ausgeführt. 

• Anweis hinter THEN oder ELSE kann aus mehreren Amiga 
Basic-Anweisungen oder-Funktionen bestehen. Diese dür¬ 
fen bei Syntax 1 und 2 zusammen mit der IF-Anweisung 
jedoch die Länge einer Amiga Basic-Programmzeile nicht 
überschreiten. 

• Hinter THEN können entweder Amiga Basic-Anweisungen 
oder -Funktionen oder aber auch eine Zeilennummer oder 
alphanumerische Sprungmarke folgen. 

• Hinter GOTO muß auf jeden Fall eine Zeilennummer oder 
alphanumerische Sprungmarke folgen. 

• Wenn die gesamte IF-Anweisung nicht dieselbe Anzahl von 
THEN- und ELSE-Klauseln enthält, bezieht sich jede ELSE- 
Klausel immer auf die nächste unerfüllte THEN-Klausel. 
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• Wenn im Direktmodus bei einer IF.. .THEN-Anweisung eine 
Zeilennummer oder alphanumerische Sprungmarke angege¬ 
ben wird, wird die Fehlermeldung 

UindeFiined label 

(Undefinierte Marke) bei logisch wahrem Ausdruck ange¬ 
zeigt, es sei denn, daß vorher im Edier-Modus eine solche 
Nummer bzw. Sprungmarke eingegeben wurde. 

• Ein IF-Block braucht nicht die erste Anweisung in einer 
Programmzeile zu sein. 

Die Anweisungssyntax 3 unterscheidet sich von den anderen 
beiden in folgenden Punkten: 

• Hier kann Anweis geschachtelte IF.. .THEN.. .ELSE-Blöcke 
enthalten. Geschachtelte Anweisungen sind bei Amiga Basic 
nicht auf eine logische Programmzeile beschränkt. Anweis 
kann hier also aus mehreren Anweisungen in aufeinanderfol¬ 
genden logischen Programmzeilen bestehen. 

• Ist Ausdr logisch “wahr“, wird Anweis hinter THEN ausge¬ 
führt und das Programm dann mit der ersten auf die END 
IF-Anweisung folgenden Anweisung fortgesetzt. 

• Ist keiner der numerischen Ausdrücke logisch “wahr“, so 
wird: 

entweder das Programm mit der ersten auf die END IF-An¬ 
weisung folgenden Anweisung fortgesetzt, 

oder Anweis hinter ELSE (falls vorhanden) ausgeführt und 
das Programm mit der ersten auf die END IF-Anweisung 
folgenden Anweisung fortgesetzt. 

• Der ELSEIF-Block ist optional. Es können beliebig viele 
ELSEIF-Blöcke angegeben werden. 

• Der ELSE-Block ist ebenfalls optional. 
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• Folgt hinter THEN eine andere Anweisung als REM oder ein 
durch ’ eingeleiteter Kommentar auf derselben Programm¬ 
zeile, so wird dies von Amiga Basic als eine einzelne IF... 
THEN.. .ELSE-Anweisung interpretiert. 

• In einer Programmzeile mit einem ELSE-, ELSEIF- oder 
END IF-Block darf der Anweisung nur eine alphanumeri¬ 
sche Sprungmarke vorangestellt werden. Andernfalls wird 
eine Fehlermeldung erzeugt. 
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INKEY$ 

Format: 

Bedeutung: 

Beispiel 1: 


Anmerkungen: 


Funktion 


v$= INKEY$ 

Es wird ein Zeichen aus dem Tastaturpuffer übergeben. Ist der 
Tastaturpuffer leer, so wird eine Leer-Zeichenkette (Länge Null) 
übergeben. 

Taste: 
a$=INKEV$ 

IF a$<>"" THEM a$=UCASE$( A$ ) 

IF fl$=" J" THEN flntuopt- 1 
IF fi$="N" THEN flntuort=Z 
IF THEN Rntuort=3 

IF Rntwort=0 THEN BEEP 
END IF 

IF flntwart=0 THEN GOTO Taste 
PRINT Antwort 

Das Programm wartet auf das Drücken einer Taste. Wurde eine 
gedrückt, so wird, falls Buchstabe, dieser in Großbuchstabe 
gewandelt. Ist es J, N oder C, wird eine Antwort ausgedruckt, 
sonst ein Piepton erzeugt und wieder gewartet. 

• INKEYS kann Zeichen grundsätzlich nur an Zeichenketten¬ 
variablen übergeben. 

• INKEYS zeigt grundsätzlich kein Zeichen an, sondern über¬ 
gibt es nur an das Programm. 

• Alle Zeichen werden von INKEYS an das Programm weiter¬ 
gereicht, mit Ausnahme von Amiga-, oder CTRL-C; diese 
Kombinationen unterbrechen das Programm. 

• Wenn bei ablaufendem Programm kein Ausgabefenster aktiv 
ist, und bei der INKEYS-Anweisung eine Taste gedrückt 
wird, wird der zugeordnete Code ignoriert und ein Piepton 
erzeugt, da beim Amiga Tastatureingaben nur an ein aktivier¬ 
tes Ausgabefenster weitergegeben werden. 

• Eine weitere Möglichkeit, Programme bis zum Eintritt eines 
bestimmten Ereignisses anzuhalten, ist die SLEEP-Anwei- 
sung (s. dort). 
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INPUT-Anweisung 


Format: INPUT[;] [“ Text]Vai[,Vai\... 

Bedeutung: Es werden Tastatureingaben während der Programmausführung 

an Variablen übergeben. 

Text Eine beliebige Zeichenkettenkonstante, die vor der Tasta¬ 
tureingabe angezeigt wird und diese z.B. näher erläutert. 

Var Beliebige numerische oder Zeichenkettenvariable oder ein 
Feldelement, die oder das den Wert der Tastatureingabe (nume¬ 
risch oder Zeichenkette) zugewiesen bekommt. 

Die INPUT-Anweisung gibt bei der aktuellen Cursor-Position 
den ggf. in der Anweisung definierten Text sowie immer ein 
Fragezeichen (?) aus und erwartet dann die Tastatureingabe 
(Cursor erscheint im aktuellen Ausgabefenster), die mit der 
Return-Taste abgeschlossen wird. 

Beispiel 1: input ix, j* 

PRINT IX, JX 

Wird dieses kleine Programm gestartet, so müssen im Ausgabe¬ 
fenster nach dem Fragezeichen zwei Zahlen eingegeben wer¬ 
den, die dann wieder angezeigt werden, also z.B.: 

?123,456 
123 456 

Ok 

Beispiel 2: pi=3.i4is9 

INPUT "Durchmesser eingebcn")D 
U=P I **D 

PRINT "Der Kreisumfang isV;U 

END 

Hier wird der Eingabeaufforderung ein Text vorangestellt, also: 

Durchmesser» eingeben ? 20 
Der Kreisumfang ist 62.8318 
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Anmerkungen: 


Die Anzeige des Fragezeichens wird unterdrückt, wenn 
hinter Text anstelle des Semikolons (;) ein Komma (,) gesetzt 
wird. 

• Werden mehrere Variablen in der INPUT-Anweisung dekla¬ 
riert, so müssen die einzelnen Eingaben durch Komma (,) 
getrennt werden. 

• Die eingegebenen Daten müssen dem Typ der Variablen 
entsprechen, der sie zugeordnet werden sollen. Zeichenket¬ 
ten müssen dann in Anführungszeichen (“) eingeschlossen 
werden, wenn sie signifikante führende oder nachfolgende 
Leerstellen oder Kommata enthalten. 

• Stimmen Typ oder Anzahl der eingegebenen Datenelemente 
nicht mit den deklarierten Variablen überein, wird mit der 
Meldung 


?Redo front start 


eine Wiederholung der gesamten Eingabe gefordert. Die 
Zuordnung zu den Variablen erfolgt erst nach der Akzeptie¬ 
rung aller Eingaben. 

Nach dem Drücken der Return-Taste ist die aktuelle Cur¬ 
sor-Position die Stelle nach dem zuletzt eingegebenen 
Zeichen, wenn unmittelbar nach dem Schlüsselwort INPUT 
ein Semikolon (;) gesetzt wird. 
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INPUT$ 

Format: 

Bedeutung: 


Beispiel: 


Anmerkungen: 


Funktion 


v$= INPUT$(n(,[#]Dafe/nr]) 

Es wird eine /»Zeichen lange Zeichenkette von der Tastatur oder 
einer sequentiellen Datei oder Einheit übernommen und einer 
Zeichenkettenvariablen zugewiesen. 

n Ein beliebiger numerischer Ausdruck, dessen ganzzahliger 
Wert zwischen 1 und 32767 liegen muß und der die Zahl der zu 
lesenden Zeichen angibt. 

Dateinr Die Nummer, unter der die Datei zum sequentiellen 
Lesen eröffnet wurde. Wird die Dateinummer weggelassen, so 
wird von der Tastatur gelesen. 

OPEN " I" , #3, "TEXT” 

Lesen - 

IF E0FC3) THEN Fertig 
PRINT ASC(INPUT$C 1,113)); 

GOTO Lesen 
Fert ig '• 

CLOSEIEND 

Von allen Zeichen in der Datei TEXT im aktuellen Diskettenlauf¬ 
werk wird der ASCII-Code auf dem Bildschirm angezeigt. 

• INPUT$ übernimmt nur die angegebene Anzahl von Zeichen. 
Beenden der Eingabe durch die Return-Taste ist nicht 
möglich. 

• INPUT$ übernimmt alle Tastencodes mit Ausnahme von 
Amiga-.; mit dieser Tastenkombination kann INPUT$ abge¬ 
brochen werden. 

• INPUT$ kennt keine Trennzeichen. 

• Alle von INPUT$ übernommenen Zeichencodes werden 
nicht auf dem Bildschirm abgebildet. 

• INPUT$ eignet sich besonders zur Übernahme von Daten 
von der Datenfernübertragungsschnittstelle, da hier alle 
ASCII-Codes Vorkommen können. 
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INPUT #-Anweisung 


Format: INPUT #Dateinr,Var[,Var\... 

Bedeutung: Es werden Daten von einer sequentiellen Datei oder Einheit 

gelesen und der (den) in der Anweisung deklarierten Variablen 
zugewiesen. 

Dateinr Die Nummer, unter der die Eingabedatei eröffnet wur¬ 
de. 

Var Der Name für eine beliebige Variable (numerisch, Zeichen¬ 
kette oder Feldelement), der die Daten zugewiesen werden 
sollen. 


Beispiel: open "text” for input ns #3 

Lesen: 

IF EOF C 3) THEN Fertig 
INPUT #3,T$:PRINT T$ 
GOTO Lesen 
Fert ig: 

CLOSE 

END 


Es werden Zeichenketten aus der sequentiellen Datei TEXT 
gelesen und angezeigt, bis das Dateiende erreicht ist. 

Anmerkungen: • INPUT # liest neben sequentiellen Diskettendateien auch 
von der Datenfernübertragungsschnittstelle oder der Tasta¬ 
tur, wenn diese als Eingabeeinheiten eröffnet wurden (s. 
Kapitel 5.1 und OPEN-Anweisung). 

• Für Datenformate und -typen gelten dieselben Regeln wie 
bei der INPUT-Anweisung (s. dort). 

• Zeichenketten, die in Anführungszeichen (“) eingeschlossen 
sind, dürfen keine weiteren Anführungszeichen enthalten. 


• Trennzeichen bei numerischen Werten sind Leerstelle, Kom¬ 
ma, Wagenrücklauf- oder Zeilenvorschub-Code. 
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• Trennzeichen bei Zeichenketten sind Komma, Wagenrück¬ 
lauf- oder Zeilenvorschubcode. Fehlt ein solches Trennzei¬ 
chen in der Zeichenkette, wird die Datenübernahme nach 
32767 Zeichen abgebrochen. 

• Wird während der Datenübernahme eines Wertes das Datei¬ 
ende erreicht, so werden der bezogenen Variablen keine 
Daten zugewiesen. 

• INPUT # darf auch bei Dateien mit wahlfreiem Zugriff 
benutzt werden, wenn diese sequentiell gelesen werden 
sollen. 

• Weitere Einzelheiten zur Dateneingabe von Dateien sind in 
Kapitel 5.4 ausführlich erläutert. 
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INSTR-Funktion 


Format: n= INSTR([/>, 

Bedeutung: Die Funktion sucht und liefert die Position des ersten Auftretens 

einer Teilzeichenkette in einer Zeichenkette. 

n Ein numerischer Ausdruck, dessen ganzzahliger Wert zwi¬ 
schen 1 und 32767 liegen muß und der die Startposition in der zu 
durchsuchenden Zeichenkette angibt. Wird n nicht angegeben, 
so beginnt die Suche bei Position 1. 

x$ Beliebiger Zeichenkettenausdruck, dessen Wert die zu 
durchsuchende Zeichenkette darstellt. 

y$ Beliebiger Zeichenkettenausdruck, dessen Wert die ge¬ 
suchte Teilzeichenkette darstellt. 

Beispiel: IF LEN( A$)<47 THEN UeitBF 

IF INSTFK45, A$,"ABC” >>0 GOTO Ausgabe 
PRINT "ABC nicht in ”A$" enthalten" 

GOTO Wo iter 
Ausgabe: 

PRINT 


Ueiter: 


Der Text ABC soll ab dem 45. Zeichen in der Zeichenkette A$ 
gesucht werden. Ist A$ kürzer als 47 Zeichen, ist die Suche 
natürlich zwecklos. 

Anmerkungen: • In den folgenden Fällen liefert INSTR den Wert Null: 

n ist größer als LEN(jr$) 
x$ ist leer 

y$ ist nicht in x$ enthalten 
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• Ist y$ leer, übergibt INSTR den Wert von />, falls n angegeben 
war, andernfalls eine 1. 

• Ungültige »-Werte werden mit 

I1legaI function ca 11 


(unerlaubter Funktionsaufruf) quittiert. 
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INT-Funktion 


Format: p=INT(.x) 

Bedeutung: Es wird der größte ganzzahlige Wert übergeben, der kleiner oder 

gleich x ist. 

x Beliebiger numerischer Ausdruck. 

Beispiel: ok 

PRINT INT(1Z.18>,INT(-14.23> 

12 15 

Ok 


Bei positiven Werten werden die Stellen rechts vom Dezimal¬ 
punkt abgeschnitten; bei negativen Werten wird abgerundet. 

Anmerkungen: • Die Funktionen FIX und CINT (s.dort) bilden ebenfalls ganz¬ 
zahlige Werte, die jedoch auf andere Art ermittelt werden. 
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KILL-Befehl 

Format: KILL Dateiangabe 

Bedeutung: Es wird die angegebene Datei auf Diskette oder Festplatte 

gelöscht. 

Dateiangabe Ein Zeichenkettenausdruck für eine Dateispezifi¬ 
kation, wie in Kapitel 5.2 beschrieben. 

Beispiel 1: kill "Adressen" 

Die Datei ADRESSEN wird im aktuellen Verzeichnis der Diskette 
im aktuellen Laufwerk gelöscht. 

Beispiel 2: kill m dfi: lager/teile. dat*' 

Die Datei TEILE.DAT im Unterverzeichnis LAGER auf der Disket¬ 
te in Laufwerk DF1: wird gelöscht. 

Anmerkungen: • Der Löschversuch bei geöffneten Dateien führt zu der Feh¬ 
lermeldung 

File a 1 ready open 


(Datei bereits geöffnet. 
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LBOUND 


Formate: 


Bedeutung: 


Beispiel: 


Anmerkungen: 


und UBOUND-Funktionen 


LBOUND (Feldname [,Dimension]) 

UBOUND (Feldname [,Dimension ]) 

Liefert die untere (LBOUND) bzw. obere (UBOUND) Grenze der 
angegebenen Dimension einer Feldvariablen. 

Feldname Name der zu untersuchenden Feldvariablen. 

Dimension Ganzzahliger Ausdruck, der die Nummer der Di¬ 
mension angibt, deren untere bzw. obere Begrenzung ermittelt 
werden soll. Voreingestellt ist hier 1. Dieser Parameter ist 
optional und für mehrdimensionale Felder vorgesehen. 

CALL INKREMENT ( FELD1C0),FELDZC),SUM()) 


SUB INKREMENT CAC2),B<2),CC2)) STfiTIC 
FOR 1= LBOUND(ft»1) TO UBOUNDtfl,1) 

FOR J-LBOUND(fl, 2) TO UBOUNDCA.2) 
C(I,J)=A(I,J)»1(I,J) 

NEXT J 
NEXT I 

END SUB 

• Die LBOUND- und UBOUND-Funktionen sind besonders 
nützlich zur Bestimmung der Größe eines Feldes, das an ein 
Unterprogramm übergeben werden soll. 

• Die untere Begrenzung ist der kleinste Index für die angege¬ 
bene Dimension des Feldes. LBOUND liefert hier entweder 0 
oder 1, je nachdem, was mit der OPTION BASE-Anweisung 
(s. dort) vereinbart wurde. 
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LEFT$-Funktion 


Format. v$= LEFT$(jr^,/») 

Bedeutung: Der linke Teil der beliebigen Zeichenkette x$ in einer Länge von n 

Zeichen wird übergeben. 

x$ Beliebiger Zeichenkettenausdruck. 

n Beliebiger numerischer Ausdruck, dessen ganzzahliger Wert 
zwischen 0 und 32767 liegen muß. 

Beispiel: ok 

C$="Commodoro Bueromaschinen" 

PRINT LEFT$(C$j9) 

Commodore 

Ok 


Die ersten 9 Zeichen der Zeichenkette C$ werden auf dem 
Bildschirm ausgegeben. 

Anmerkungen: 9 Ist n größer als die Länge von x$, so wird x$ vollständig 
übergeben. 

• Bei n =0 wird eine Leer-Zeichenkette (Länge 0) übergeben. 

9 Weitere teilkettenbildende Funktionen sind MID$ und 
RIGHT$ (s. dort). 
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LEN-Funktion 


Format: k=LEN(x$) 

Bedeutung: Es wird die Länge der Zeichenkette x$ übergeben. 

x$ Beliebiger Zeichenkettenausdruck 


Beispiel: 


Ok 

C$="CommodoreBueromaschinen" 
PRINT LEN(C$> 

24 

Ok 


C$ ist 24 Zeichen lang. Leerzeichen sowie alle nicht druckbaren 
Zeichen werden mitgezählt. 
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LET-Anweisung 


Format: [LET] Var= Ausdruck 

Bedeutung: Der Wert eines beliebigen Ausdrucks wird einer Variablen zuge¬ 

wiesen. 

Var Jede beliebige einfache Variable oder jedes beliebige 
Feldelement. 


Ausdruck Jeder beliebige Amiga Basic-Ausdruck. 


Beispiel: LET Commodore ''^"Bueronasch inen" 

LET X=nT2»SQR(Z10) 

Anmerkungen: • Das Schlüsselwort LET kann auch weggelassen werden. Das 
Gleichheitszeichen ( = ) ist für eine Zuweisung ausreichend. 

• Der Typ des Ausdrucks muß mit dem Variablentyp überein¬ 
stimmen; andernfalls wird die Fehlermeldung 


Type mismatch 


(keine Typübereinstimmung) angezeigt. 
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LIBRARY-Anweisung 


Format: LIBRARY “Dateinamef 

LIBRARY CLOSE 

Bedeutung: Es wird eine Bibliothek mit Maschinensprache-Unterprogram¬ 

men für den Zugriff aus Amiga Basic heraus geöffnet. 

Dateiname Der Name der Datei, die die benötigten Maschinen¬ 
sprache-Unterprogramme oder -Funktionen enthält. 

LIBRARY CLOSE schließt alle geöffneten Bibliotheken. 

Beispiel: LI BRARY "graphics. Iibrary" 

CALL SetDrMd« (UINDOWC8),3) 

Anmerkungen: • Es können bis zu 5 Bibliotheken für den Zugriff aus Amiga 
Basic heraus gleichzeitig geöffnet sein. 

• Der Zugriff bleibt solange erlaubt, bis der NEW- oder RUN- 
Befehl oder die LIBRARY CLOSE-Anweisung gegeben wird. 

• Wird die angegebene Bibliothek nicht gefunden, so wird die 
Fehlermeldung 

File not found 

(Datei nicht gefunden) angezeigt. Reicht der Speicher für 
das Öffnen einer Bibliothek nicht aus, wird die Fehlermel¬ 
dung 

Out of memory 

(Hauptspeicher nicht ausreichend) angezeigt. 

• Um die LIBRARY-Anweisung verwenden zu können, muß 
zuerst eine .bmap-Datei auf Diskette erzeugt werden, in der 
die Unterprogramme der betreffenden Bibliothek beschrie¬ 
ben sind. 

• Anhang F enthält ausführliche Informationen über das Erstel¬ 
len von Bibliotheksdateien. 
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LINE-Anweisung 


Format: LINE [[STEP] (x1,y1)]-[STEP] (x2,y2>[,[Farbe][, B[F]]] 

Bedeutung: Es wird eine Linie oder ein Viereck auf dem Bildschirm gezeich¬ 

net. 

( x1,y1),(x2,y2) Absolute Bildschirmkoordinaten des Anfangs¬ 
und Endpunktes der Linie. Wird der Zusatz STEP verwendet, sind 
. die Koordinaten relativ zur augenblicklichen Position des grafi¬ 
schen Cursors (Pixel-Cursor). 

Farbe Eine Farbnummer zwischen 0 und 3 entsprechend der 
mit einer PALETTE-Anweisung (s. dort) gesetzten Farbkennung. 
Voreingestellt ist die Vordergrundfarbe, die mit der COLOR-An- 
weisung (s. dort) eingestellt wurde oder die von Amiga Basic 
standardmäßig verwendet wird (weiß). 

B Es wird ein Viereck gezeichnet, dessen gegenüberliegende 
Ecken durch xl.yl und x2,y2 gegeben sind. 

BF Das Viereck wird mit der gegebenen Farbe ausgemalt. 

Beispiel 1: line -tiee, iee) 

Vom letzten angegebenen Punkt wird eine Linie zum Punkt mit 
den Koordinaten 100,100 in der aktuellen Vordergrundfarbe 
gezeichnet. 

Beispiel 2: line c0,0)-<639,199),3 

Es wird eine Diagonale von oben links nach unten rechts in der 
Farbe 3 der aktuellen Farbskala gezeichnet. 

Beispiel 3: line <0,0>-<i00,100),, bf 

Es wird ein Viereck in der aktuellen Vordergrundfarbe gezeichnet 
und ausgemalt. 
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Anmerkungen: O Werden Koordinaten außerhalb des gültigen Bereiches an¬ 
gegeben, so wird der sich daraus ergebende Bildteil an den 
Grenzen des sichtbaren Bereiches abgeschnitten. 

• Nach Ausführung der LINE-Anweisung bezeichnet die Koor¬ 
dinate x2,y2 die aktuelle Position des grafischen Cursors. 
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LINE INPUT-Anweisung 


Format: LINE INPUT[;] [“ Text \Zeikettvar 

Bedeutung: Es wird eine Zeichenkette bis zu 255 Zeichen von der Tastatur 

übernommen und einer angegebene Variablen zugewiesen. Es 
gibt im Gegensatz zur INPUT-Anweisung kein anderes Trennzei¬ 
chen als den Wagenrücklaufcode; es werden also alle Zeichen, 
auch vorlaufende und nachfolgende Leerzeichen, in die Zeichen¬ 
kette übernommen. Drücken der RETURNTaste schließt die 
Eingabe ab. 

Texf Eine beliebige Zeichenkettenkonstante, die vor der Tasta¬ 
tureingabe angezeigt wird und diese z.B. näher erläutert. 

Zeikettvar Eine beliebige Zeichenkettenvariable oder ein belie¬ 
biges -Feldelement. 

Beispiel: LINE INPUT "Namen eingeben: " ; f)$ 

PRINT n$ 

Dies ergibt, wenn die geforderten Daten eingegeben werden, 
z.B: 

Namen eingeben: Müller, Alfons 
Müller, Alfons 
Ok 

Das Komma zwischen Nach- und Vorname gehört zur Eingabe 
und wird nicht als Trennzeichen erkannt. 

Anmerkungen: • Wird eine numerische Variable angegeben, so meldet der 
Interpreter den Fehler 

Type m i smatch 

(keine Typübereinstimmung). 

• Im Gegensatz zur INPUT-Anweisung wird vor dem blinken¬ 
den Cursor, der zur Eingabe auffordert, kein Fragezeichen 
(?) ausgegeben. 
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• Nach dem Drücken der RETURN-Taste ist die aktuelle 
Cursorposition die Stelle hinter dem zuletzt eingegebenen 
Zeichen, wenn direkt hinter dem Schlüsselwort LINE INPUT 
ein Semikolon (;) angegeben wird; andernfalls ist es die 
erste Schreibposition der nächsten Zeile. 

• Die LINE INPUT-Anweisung kann durch Drücken der beiden 
Tasten Amiga- oder CTRL-C abgebrochen werden. Der 
Interpreter kehrt dann auf die Befehlsebene zurück. Ein ggf. 
dann eingegebener CONT-Befehl setzt das Programm mit 
der abgebrochenen LINE INPUT-Anweisung fort. 
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LINE INPUT #-Anweisung 


Format: LINE INPUT #Dateinr,Zeikettvar 

Bedeutung: Es werden Daten zeilenweise (bis zu 32767 Zeichen) aus einer 

sequentiellen Datei gelesen und einer Zeichenkettenvariablen 
zugewiesen. Es gibt im Gegensatz zu der Anweisung INPUT # 
keine Trennzeichen (Komma oder Leerstellen). Der Wagenrück¬ 
laufcode beendet den Lesevorgang. 

Dateinr Die Nummer, unter der die Eingabedatei eröffnet 
wurde. 


Zelkettvar Eine beliebige Zeichenkettenvariable oder ein belie¬ 
biges -Feldelement. 

Beispiel: open "nomen" for input ns »3 

LINE INPUT «3, A$ 

PRINT n$: CLOSE 3 

Es wird eine Zeichenkette aus der Datei NAMEN gelesen und 
angezeigt. 


Anmerkungen: • Mit der LINE INPUT #-Anweisung werden grundsätzlich alle 
Zeichen bis zum Wagenrücklaufcode übernommen. Bei der 
nächsten LINE INPUT #-Anweisung werden der Wagen¬ 
rücklauf- sowie ein ggf. folgender Zeilenvorschubcode der 
vorher gelesenen Zeichenkette übergangen, und es wird bis 
zum nächsten Wagenrücklaufcode gelesen. 
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LIST-Befehl 


Format: LIST [Zeile 1][-[ZeiieZ^ [, Dateiang] 

Bedeutung: Das aktuelle, sich im Hauptspeicher befindende Amiga Basic- 

Programm wird im List-Fenster oder einer anderen spezifizierten 
Ausgabeeinheit gelistet. 

Zeile1,Zeile2 Gültige Zeilennummern im Bereich 0 bis 65529 
oder alphanumerische Sprungmarken. Es wird immer einschließ¬ 
lich Zeilel und Zei!e2 gelistet. 

Dateiang Ein Zeichenkettenausdruck für eine Dateispezifikati¬ 
on, wie in Kapitel 5.2 Wird die Dateiangabe weggelassen, so wird 
der angegeben Zeilenbereich im List-Fenster gelistet. 

Beispiel 1: list 

Das gesamte Programm wird im List-Fenster gelistet. 

Beispiel 2: list-100,”scrn:" 

Alle Zeilen bis Zeile 100 einschließlich werden im List-Fenster 
gelistet. 

Beispiel 3: list ,"lpti:" 

Ausdruck des gesamten Programms auf dem Drucker. 

Beispiel 4: list 1000-,"com:2400 ,n,b" 

Alle Zeilen des Programms ab Zeile 1000 werden über den 
Datenfernübertragungsanschluß mit 2400 Baud ohne Parität mit 
8 Daten-Bits und einem Stop-Bit übertragen (s.a. Kapitel 5.1). 

Anmerkungen: • Die Ausgabe der Programmliste in eine Disk-Datei erfolgt im 
ASCII-Format. 

• Nach der Ausführung von LIST kehrt der Interpreter grund¬ 
sätzlich zur Befehlsebene zurück. 

• Kapitel 3.3 und 4.1 enthalten weitere Hinweise zur Verwen¬ 
dung des List-Fensters. 
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LLIST-Befehl 


Format: LUST [Zeiie1}[-[Zeiie2\] 

Bedeutung: Der angegebene Zeilenbereich oder das gesamte im Hauptspei¬ 

cher befindliche Amiga Basic-Programm wird auf dem Drucker 
(PRT:) gelistet. Für die Zeilenangaben gelten dieselben Regeln 
wie beim LIST-Befehl (s. dort). 

Beispiele: llist 

Listet das gesamte Programm 


LLIST -100 

Listet alle Programmzeilen bis einschließlich Zeile 100. 

LLIST 100-200 

Listet alle Programmzeilen zwischen den Zeilen 100 und 200 
einschließlich. 


LLIST 1000- 

Listet alle Programmzeilen ab einschließlich Zeile 1000. 

Anmerkungen: • Nach der Ausführung von LLIST kehrt der Interpreter grund¬ 
sätzlich zur Befehlsebene zurück. 

• Die Ausgabe erfolgt grundsätzlich auf dem Drucker PRT: 
(s.a. AmigaDOS-Benutzerhandbuch). 
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LOAD-Befehl 


Format: LOAD [Dateiangabe{, R]] 

Bedeutung: Es wird ein Programm von einer angegebenen Eingabeeinheit in 

den Hauptspeicher geladen und ggf. gestartet. 

Dateiangabe Ein Zeichenkettenausdruck für eine Dateispezifi¬ 
kation, wie in Kapitel 5.2 beschrieben. 


R Wird der Parameter R angegeben, so wird das geladene 
Programm gestartet. Andernfalls kehrt der Interpreter nach dem 
Ladevorgang zur Befehlsebene zurück. 

Beispiel 1: load"progi" 

Das Programm PROG1 wird von der Diskette im aktuellen 
Laufwerk geladen. 

Beispiel 2: load " dfi : prog2”,r 


Das Programm PROG2 wird von der Diskette in Laufwerk DF1: 
geladen und gestartet. 


Anmerkungen: • Wird keine Dateiangabe gegeben, so wird der Anwender mit 
einem Kommunikationsfenster zur Eingabe des gewünsch¬ 
ten Dateinamens aufgefordert. 

• Die Dateiangabe muß den Dateinamen enthalten, unter dem 
das Programm ursprünglich mit SAVE (s. dort) gespeichert 
wurde. 


• Durch den Befehl LOAD ohne Angabe von R werden vor dem 
Laden alle ggf. geöffneten Dateien geschlossen, und das 
ggf. vorher im Speicher befindliche Programm wird gelöscht. 

• Beim LOAD-Befehl mit Angabe von R bleiben alle ggf. vorher 
geöffneten Dateien geöffnet. Auf diese Weise können Pro¬ 
gramme verkettet werden, wobei allerdings die Datenüber¬ 
gabe über Diskettendateien erfolgen muß (s.a. RUN-Befehl). 

• Siehe auch CHAIN-Anweisung sowie MERGE- und SAVE- 
Befehl. 
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LOC-Funktion 


Format: v= LOC(Dateini) 

Bedeutung: Bei Direktzugriffsdateien liefert die LOC-Funktion die Nummer 

des zuletzt gelesenen oder geschriebenen physikalischen Da¬ 
tenblocks. 

Bei sequentiellen Dateien liefert die LOC-Funktion die Anzahl 
der bereits geschriebenen oder gelesenen Bytes, dividiert durch 
die voreingestellte (128) oder gewählte Satzlänge. 

Dateinr Die Nummer, unter der die bezogene Datei eröffnet 
wurde. 

Beispiel 1 : ifloco» 10 then see 

Wird nach dem 10. Datenblock noch ein Block gelesen (oder 
geschrieben), verzweigt das Programm nach Zeile 500. 

Beispiel 2: put m. locc 2 > 

Der zuletzt gelesene Satz wird überschrieben. 

Anmerkungen: • Bei sequentiellen Dateien liefert LOC vor dem ersten Lesen 
eine 1, da beim Eröffnen der Datei bereits der erste Daten¬ 
block gelesen wird. 

• Wird eine Datei für KYBD: (Tastatur) oder COM1: (serielle 
Schnittstelle) geöffnet und darauf die LOC-Funktion ange¬ 
wendet, so erhält man den Wert 1, wenn irgendwelche Daten 
zum Auslesen bereitstehen, andernfalls 0. 
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LOCATE 


Format: 


Bedeutung: 


Beispiel: 


Anmerlungen: 


Anweisung 


LOCATE [Zeile][,Spalte] 


Positioniert den Textcursor im aktuellen Ausgabefenster. 

Zelle Ein ganzzahliger Ausdruck, dessen Wert größer als 0 sein 
muß, und der die Zeile angibt, in der der Cursor positioniert 
werden soll. 

Spalte Ein ganzzahliger Ausdruck, dessen Wert größer als 0 
sein muß, und der die Spalte angibt, in der der Cursor positioniert 
werden soll. 

Y— CSRLI N * merkt sich vert ika Ie Pos it ion 
X=POS( 0 ) ‘ merkt, s ich hör izonta 1 e Pos i t ion 
LOCATE 20, 1 

PRINT "Dies ist Ze i le 20 ( Sch irm—Ende )" 

LOCATE Y, X 

PRINT ”D i es war die ursprUng 1 iche Cursor—Pos i t ion" 


Bei diesem Beispiel wird die alte Cursor-Position gespeichert, 
dann am unteren Schirmende eine Meldung angezeigt und 
schließlich eine weitere Meldung bei der ursprünglichen Cur¬ 
sor-Position angezeigt. 

• Zeilen- und Spaltenangaben müssen für das bezogene 
Ausgabefenster gültige Werte haben. 

• Zur Bestimmung der exakten Bildschirmposition benutzt 
Amiga Basic die Höhe und Breite der Ziffer Null (0) des für 
das aktuelle Ausgabefenster gewählten Zeichensatzes. 


Werden Zeilen- und Spalten-Parameter weggelassen, so 
nimmt LOCATE die aktuelle Position des Text-Cursors. 
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LOF-Funktion 

Format: v= LOF(Dateinr) 

Bedeutung: Es wird die Länge einer Datei in Bytes übergeben. 

Dateinr Nummer, unter der die Datei eröffnet wurde. 

Beispiel: open "Adressen" as #3 len=5iz 

PRINT LOF(3)^51Z 

Es wird die Anzahl von 512-Byte langen Datenblöcken in der 
Direktzugriffsdatei ADRESSEN angezeigt. 

Anmerkungen: • Bei Dateien, die für SCRN: (Bildschirm), KYBD: (Tastatur), 
LPT1: (Drucker) oder COM1: (serielle Schnittstelle) geöffnet 
wurden, liefert LOF immer den Wert 0. 
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LOG-Funktion 


Format: v= LOG(x) 

Bedeutung: Es wird der natürliche Logarithmus eines beliebigen numeri¬ 

schen Ausdruckes größer als 0 berechnet. Ist das Argument 
einfach genau, erfolgt die Berechnung auch in einfacher Ge¬ 
nauigkeit. Ist es doppelt-genau, wird auch ein doppelt-genauer 
Wert übergeben. 

x Beliebiger numerischer Ausdruck, dessen Wert größer als 
Null sein muß. 

Beispiel 1: frintlog(z.7ibz82) 

i 

Ok 

Der natürliche Logarithmus der Zahl e ist 1. 

Beispiel 2: print log<-d 

führt zur Fehleranzeige 

Illegal function call 

(Unerlaubter Funktionsaufruf). 

Der natürliche Logarithmus ist nur für positive Zahlen definiert. 
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LPOS-Funktion 


Format: p=LPOS(/j) 

Bedeutung: Es wird die Position des zuletzt gedruckten Zeichens im Druk- 

kerpuffer übergeben. 

nist ein Scheinargument ohne Bedeutung, das jedoch angege¬ 
ben werden muS. 

Beispiel: if lposcx >>80 then lprint chr$c 13 ) 

Spätestens nach dem 80. Zeichen soll ein Wagenrücklaufcode 
gedruckt werden. 

Anmerkungen: • Der von LPOS gelieferte Wert muß nicht zwingend mit der 
physikalischen Druckkopfposition im Drucker übereinstim¬ 
men. 
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LPRINT 


Format: 


Bedeutung: 


Beispiel: 


Anmerkungen: 


und LPRINT USING-Anweisungen 


LPRINT [Liste von Ausdi§\\ 

LPRINT USING v$\Liste von Ausdi[\\ 

Es werden Daten auf dem Drucker LPT1: ausgegeben. 

Liste von Ausdr Eine beliebige Liste von numerischen und/ 
oder Zeichenkettenausdrücken, deren Werte gedruckt werden 
sollen. Die einzelnen Ausdrücke müssen durch Komma (,) oder 
Semikolon (;) getrennt sein, wenn der vorangegangene Aus¬ 
druck nicht mit einem der Zeichen )$#%&“ endet. Die Liste 
muß zusammen mit dem Schlüsselwort LPRINT oder LPRINT 
USING in einer Programmzeile stehen. 

v$ Zeichenkettenvariable oder -konstante, die das Druckfor¬ 
mat bestimmt (s. dazu PRINT USING-Anweisung). 

Da LPRINT und LPRINT USING genauso wie PRINT und PRINT 
USING arbeiten, wird auf die dort angeführten Beispiele verwie¬ 
sen. 

• Es wird eine Druckbreite von 80 Zeichen vorausgesetzt, so 
daß nach dem Drucken des 80. Zeichens vom Interpreter 
automatisch ein Wagenrücklauf/Zeilenvorschub an den 
Drucker ausgegeben wird. Beim Drucken von exakt 80 
Zeichen langen Zeilen sollte die zu druckende Liste von 
Ausdrücken deshalb mit einem Semikolon (;) in der Anwei¬ 
sung abgeschlossen werden. Die Druckbreite kann mit der 
Anweisung WIDTH “LPT1:“ oder WIDTH LPRINT (s. dort) 
geändert werden. 
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LSET-Anweisung 


Format: LS ET Zelchenkettenvarlable** x$ 


Bedeutung: Überträgt in Vorbereitung für die PUT-Anweisung für Dateien 

Daten linksbündig in einen Dateipuffer für wahlfreien Zugriff 
(Direktzugriffsdatei). 

Zeichenkettenvariable Der Name einer Variablen, die in einer 
FIELD-Anweisung als Datenfeld definiert wurde. 

x$ Beliebiger Zeichenkettenausdruck, dessen Wert die Daten 
repräsentiert, die in dem durch die Zeichenkettenvariable be¬ 
stimmten Feld linksbündig abgelegt werden sollen. 


Beispiel: lset y$=mks$c hum > 

Der numerische Wert NUM wird bei der linksbündigen Speiche¬ 
rung im Datenfeld Y$ als Zeichenkette interpretiert (s. Anmer¬ 
kungen und MKS$-Funktion). 


Anmerkungen: • Ist die zu speichernde Datenlänge kleiner als das definierte 
Feld, so wird das Feld rechts mit Leerstellen aufgefüllt. Ist sie 
größer, wird rechts abgeschnitten. 

• Numerische Werte müssen vor der Speicherung mit LSET 
oder RSET (s. dort) durch die Funktionen MKI$, MKL$, 
MKS$ oder MKD$ (s. dort) als Zeichenketten interpretiert 
und behandelt werden. 


• In LSET- und RSET-Anweisungen können auch durch ande¬ 
re als durch FIELD-Anweisungen definierte Datenfelder ver¬ 
wendet werden (z.B. für Druckformat-Erstellung). 

• Weitere Informationen zum Datenaustausch mit Dateien für 
wahlfreien Zugriff sind in Kapitel 5.4 zu finden. 
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MENU-Anweisung 


Format: MENU Kennung,Punkt,Status[,Tltel\ 

MENU RESET 

Bedeutung: Erzeugt ein Anwender-Menü in der Menü-Leiste mit Menü- 

Punkten oder setzt die Menü-Leiste auf ihren Originalzustand 
zurück. 

Kennung Ein ganzzahliger Ausdruck, dessen Wert zwischen 1 
und 10 liegen muß, und der die Nummer des Menütitels in der 
Menü-Leiste angibt. 

Punkt Ein ganzzahliger Ausdruck, dessen Wert zwischen 0 und 
19 liegen muß, und der die Nummer des Menü-Punktes unter¬ 
halb des Titels in der Menü-Leiste angibt. Der Wert 0 spezifiziert 
einen Menü-Titel. 

Status Ein ganzzahliger Ausdruck, dessen Wert zwischen 0 und 
2 liegen muß. Ein Wert von 0 inaktiviert je nach Wert von Punkt 
das gesamte Menü oder den spezifizierten Menü-Punkt. Ein 
Wert von 1 aktiviert das gesamte Menü oder den spezifizierten 
Menü-Punkt. Ein Wert von 2 aktiviert den spezifizierten Menü¬ 
punkt und versieht ihn mit einer entsprechenden Kennzeich¬ 
nung. Soll ein Menü-Punkt mit Kennzeichnung versehen wer¬ 
den, so müssen bei seinem Titel zwei Leerstellen vor dem Text 
vorgesehen werden. 

Titel Ein Zeichenkettenausdruck oder eine Zeichenkettenkon¬ 
stante in Anführungszeichen (“), dessen/deren Wert den Titel für 
das Menü in der Menü-Leiste oder die Bezeichnung des Menü¬ 
punktes darstellt. 

Beispiel: MENU 1,0, l/'Kontenbeuegungen" 

MENU 1, 1, 1,"Einzahlungen" 

MENU 1,2« 1 1 "Entnahmen" 

MENU 1« 3, 1,"Dauerauftraege” 

MENU 1,4, l/'Kreditkarten-Kauf' 
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Diese Anweisungen richten in der Menü-Leiste an erster Positi¬ 
on das Menü “Kontenbewegungen“ mit 4 Menü-Punkten ein und 
aktivieren es. 

Anmerkungen: • Wenn ein Status von 1 bei einer Menü-Titelspezifikation 
angegeben wird, so wird dieser Titel anstelle des vorher dort 
befindlichen Titels in der Titelleiste angezeigt. 
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MENU-Funktion 


Format: K=MENU(n) 

Bedeutung: Liefert die Nummer des zuletzt gewählten Menü-Titels oder 

-Punktes. 


n Ein ganzzahliger Ausdruck, dessen Wert 0 oder 1 sein darf 
und der folgende Bedeutung hat: 

0 Es wird die Nummer des zuletzt gewählten Menü-Titels 
übergeben. MENU(O) wird nach jeder Ausführung zurückge¬ 
setzt, so daß die Menü-Leiste so abgefragt werden kann wie 
die Tastatur mit der INKEY$-Funktion. 

1 Es wird die Nummer des zuletzt gewählten Menü-Punktes 
übergeben. 


Beispiel: Henu=nENuce) 

MenuPunkt'MENLK 1) 


Anmerkungen: • Weitere Anweisungen im Zusammenhang mit der Arbeit mit 
Menüs sind MENU, MENU ON, ON MENU und SLEEP (s. 
dort). 
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MENU ON/OFF/STOP-Anweisungen 


Formate: MENU ON 

MENU OFF 
MENU STOP 

Bedeutung: Die Unterbrechungsreaktionsfähigkeit bei Menü-Benutzung 

durch den Anwender wird aktiviert oder inaktiviert. 


Beispiel: ON MENU GOSUB Testflenu 

ON liOUSE GOSUB TestMaus 
MENU ON 
MOUSE ON 


Anmerkungen: • Die Anweisung MENU ON muß ausgeführt werden, um eine 
Unterbrechungsverzweigung bei Menu-Benutzung durch 
den Anwender zu erreichen. 


• Nach MENU OFF kann bei Menü-Benutzung nicht mehr 
programmiert verzweigt werden. 

• Nach MENU STOP speichert Amiga Basic eine Menu-Benut¬ 
zung durch den Anwender, unterbricht das Programm mit 
einer Verzweigung aber erst, sobald eine MENU ON-Anwei- 
sung gegeben wird. 

• Weitere Hinweise finden Sie bei den MENU- und ON ME- 
NU-Anweisungen sowie im Kapitel 6.4. 
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MERGE- 

Format: 

Bedeutung: 

Beispiel: 

Anmerkungen: 


Befehl 


MERGE Dateiangabe 

Es wird eine Amiga Basic-Programmdatei im ASCII-Format an 
ein im Hauptspeicher befindliches Proramm angefügt. 

Dateiangabe Ein Zeichenkettenausdruck für eine Dateispezifi¬ 
kation, wie in Kapitel 5.2 beschrieben. 

MERGE "PROGZ" 

Ok 

Das Programm PROG2 auf der Diskette im aktuellen Laufwerk 
wird an das hauptspeicherresidente Programm angefügt. 

• Nach MERGE kehrt Amiga Basic grundsätzlich auf die Be¬ 
fehlsebene in den Direktmodus zurück. 

• Wurde das anzufügende Programm nicht im ASCII-Format 
gespeichert (s. SAVE-Befehl), so wird der Mischvorgang mit 
der Fehlermeldung 


Bad f i le mode 


(falscher Dateityp) abgebrochen und das hauptspeicherresi¬ 
dente Programm wird nicht verändert. 
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MID$-Anweisung 


Format: MID$(v $,r{,m]) = x$ 

Bedeutung: Es wird ein Teil einer Zeichenkette durch eine andere Zeichen¬ 

kette ersetzt. 

v$ Die Zeichenkettenvariable oder das -feldelement, von der/ 
dem ein Teil ersetzt werden soll. 


n Ein ganzzahliger Ausdruck mit einem Wert zwischen 1 und 
32767, der die Position angibt, ab der ersetzt werden soll. 

m Ein ganzzahliger Ausdruck mit einem Wert zwischen 0 und 
32767, der, wird er angegeben, die Anzahl der zu ersetzenden 
Zeichen bestimmt. Andernfalls wird ab Position n mit dem 
gesamten x$ ersetzt. 

x$ Ein beliebiger Zeichenkettenausdruck, dessen Wert die 
Daten darstellt, die einen Teil von ^ersetzen sollen. 


Beispiel: ft$-"Cpmmodare BuerpMaschinen" 

MID$(A$,11)="Deutschland " 

PRINT 

Commodore Deutschland 
Ok 

Anmerkungen: • Grundsätzlich wird die Länge von v$ nicht verändert, wenn 
ersetzt wird, d.h. es werden maximal so viele Zeichen 
ersetzt, wie LEN(p$)-/j+ 1 angibt. 

• Liegen n und m außerhalb des angegebenen Bereiches, wird 
die Fehlermeldung 


I 1 lega I funct ion ca 1 1 


(unerlaubter Funktionsaufruf) angezeigt. 
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MID$-Funktion 


Format: v$= MID$(x$,/](,/n]) 

Bedeutung: Es wird ein spezifizierter Teil einer Zeichenkette übergeben. 

x$ Ein beliebiger Zeichenkettenausdruck, von dessen Wert ein 
Teil übergeben werden soll. 

n Ein ganzzahliger Ausdruck zwischen 1 und 32767, der die 
Position angibt, an der die Teilzeichenkette beginnt. 

m Ein ganzzahliger Ausdruck zwischen 0 und 32767, der, wird 
er angegeben, die Länge der zu bildenden Teilzeichenkette 
angibt. Wird m weggelassen oder existieren von Position n an 
weniger als m Zeichen, werden von n an alle Zeichen von x$ 
übergeben. Ist m gleich Null, oder ist n größer als LEN(x$), so 
wird eine Leer-Zeichenkette (Länge Null) übergeben. 

Beispiel: A$="Heute ist" 

B$="Sonnta 9 MontagDienstag" 

PRINT n$;t1ID$(B$,8,6) 

Heute ist Montag 
Ok 

Anmerkungen: • Liegen n und m außerhalb des angegebenen Bereiches, wird 
der Fehler 

I I Iega1 function ca 11 


(unerlaubter Funktionsaufruf) angezeigt. 
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MKI$-, MKL$-, MKS$-, MKD$-Funktionen 


Formate: v$= M KIS ( kurz-ganzzahliger Ausdruck) 

v$= M KL$ ( lang-ganzzahliger Ausdruck) 
v$= MKS$(einfachgenauer Ausdruck) 
v$= MKD $(doppeltgenauer Ausdruck) 

Bedeutung: Es werden die Werte numerischer Ausdrücke unterschiedlicher 

Genauigkeit in ihrer internen Darstellung (s. Anhang E) als 
Zeichenketten interpretiert. 

Beispiel: open "b: lrger" es #3 

FIELD *3, Z ns BFTNP$, Z0 RS BEZ$, Z RS STZ$ 

FOR 1 = 1 TO 100 

LSET RRTNR$=f1KI $( RN%( I ) ) 

LSET BEZ$=BZ$CI ) 

LSET STZ$=SZ$(I) 

PUT #3, I 
HEXT 


In diesem Beispiel werden nach der Eröffnung einer Datei für 
wahlfreien Zugriff jedem Datensatz drei Variablen unterschiedli¬ 
cher Länge zugeordnet. In einer Schleife werden die Werte in den 
Puffer übertragen, wobei die Artikelnummer aus einem Ganz¬ 
zahlfeld AN%(I) mit Hilfe der Funktion MKI$ als Zeichenkette 
interpretiert, in den Datensatz eingefügt und dann der Datensatz 
auf Disk gespeichert wird. 


Anmerkungen: • Soll der Wert eines numerischen Ausdruckes in einen Datei¬ 
puffer für wahlfreien Zugriff mit Hilfe der LSET- oder RSET- 
Anweisung gebracht werden, so muß er dazu vorher ent¬ 
sprechend seiner Genauigkeit mit einer der hier beschriebe¬ 
nen Funktionen als Zeichenkette umdefiniert werden, die, 
ebenfalls abhängig von der Genauigkeit, folgende Länge 
benötigt: 


MKI$ 2 Bytes 
MKL$ 4 Bytes 
MKS$ 4 Bytes 
MKD$ 8 Bytes 
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• Der Unterschied zur STR$-Funktion besteht darin, daß hier 
die Datenbytes nicht verändert, sondern nur anders interpre¬ 
tiert werden (s.a. CVI-, CVL-, CVS-, CVD-Funktionen, 
LSET- und RSET-Anweisungen sowie Kapitel 5.4). Die 
MKx$-Funktionen liefern also Zeichenketten, die die ange¬ 
gebenen numerischen Werte in der internen binären Darstel¬ 
lung (Ganzzahl oder Gleitpunkt) repräsentieren. 
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MOUSE 

Format: 

Bedeutung: 


Funktion 


v= MOUSE(/7) 

Die MOUSE-Funktion liefert Informationen über den Status der 
linken Maus-Taste (Auswahltaste) sowie über den Maus-Zeiger 
(Pfeil) innerhalb des aktiven Fensters. 

n Ein ganzzahliger Ausdruck, dessen Wer t zwischen 0 und 6 
liegen muß und der die von der Funktion gelieferte Information 
bestimmt: 

0 Liefert den Status der linken Maus-Taste. Nach der Ausfüh¬ 
rung von MOUSE(O) speichert Amiga Basic Start- und 
End-Positionen der Maus, bis eine weitere MOUSE(O)- 
Funktion ausgeführt wird. Deshalb sollte ein Programm nach 
der Wahrnehmung einer Mausbewegung durch MOUSE(O) 
mit Hilfe der Funktionen MOUSE(3), MOUSE(4), MOUSE(5) 
und MOUSE(6) (s. unten) Start- und Endpositionen der 
Maus feststellen. MOUSE(O) liefert folgende Werte: 

0 Die linke Maustaste ist gegenwärtig nicht gedrückt und 
wurde auch seit dem letzten MOUSE(0)-Funktionsaufruf 
nicht gedrückt. 

1 Die linke Maustaste ist gegenwärtig nicht gedrückt, 
wurde jedoch seit dem letzten MOUSE(0)-Funktionsauf- 
ruf einmal gedrückt. Zur Bestimmung der Start- und 
Endpositionen der Maus während der Auswahl sind die 
Funktionen MOUSE(3), MOUSE(4), MOUSE(5) und 
MOUSE(6) zu verwenden. 

2 Die linke Maustaste ist gegenwärtig nicht gedrückt, 
wurde jedoch seit dem letzten MOUSE(0)-Funktionsauf- 
ruf zweimal gedrückt. Zur Bestimmung der Start- und 
Endpositionen der Maus während der Auswahl sind die 
Funktionen MOUSE(3), MOUSE(4), MOUSE(5) und 
MOUSE(6) zu verwenden. (Entsprechend bedeutet ein 
Wert von 3, daß die Auswahltaste dreimal gedrückt 
wurde usw.). 
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-1 Der Anwender hält die linke Maustaste nieder, nachdem 
er sie einmal gedrückt hatte. Dieser Wert bedeutet 
meistens, daß die Maus gegenwärtig bewegt wird. 

-2 Der Anwender hält die linke Maustaste nieder, nachdem 
er sie zweimal gedrückt hatte. Dieser Wert bedeutet 
meistens, daß die Maus gegenwärtig bewegt wird. (Ent¬ 
sprechend bedeutet ein Wert von -3, daß die Auswahlta¬ 
ste vor dem Niederhalten dreimal gedrückt wurde usw.). 

1 MOUSE(I) liefert die horizontale x-Koordinate zum Zeit¬ 
punkt des letzten MOUSE(0)-Funktionsaufrufes, und zwar 
unabhängig vom Status der Auswahltaste. 

2 MOUSE(2) liefert die vertikale y-Koordinate zum Zeitpunkt 
des letzten MOUSE(0)-Funktionsaufrufes, und zwar unab¬ 
hängig vom Status der Auswahltaste. 

3 MOUSE(3) liefert die horizontale x-Koordinate zum Zeit¬ 
punkt der letzten Betätigung der Auswahltaste vor einem 
MOUSE(0)-Funktionsaufruf. MOUSE(3) in Verbindung mit 
MOUSE(4) (s. unten) dient zur Bestimmung der Startkoordi¬ 
naten einer Mausbewegung. 

4 MOUSE(4) liefert die vertikale y-Koordinate zum Zeitpunkt der 
letzten Betätigung der Auswahltaste vor einem MOUSE(O)- 
Funktion saufruf. 

5 Wenn die linke Maustaste nach dem letzten MOUSE(0)-Funkti- 
onsaufruf gedrückt wurde, liefert MOUSE(5) die horizontale 
x-Koordinate der Position, bei der der Maus-Cursor war, als 
MOUSE(O) aufgerufen wurde. War die linke Maustaste dage¬ 
gen nach dem letzten MOUSE(0)-Funktionsaufruf nicht ge¬ 
drückt, liefert MOUSE(5) die horizontale x-Koordinate der 
Position, bei der die linke Maustaste losgelassen wurde. Mit der 
MOUSE(5)-Funktion kann die Mausbewegung verfolgt werden 
und die Position bestimmt werden, bei der die Bewegung 
aufgehört hat. 

6 MOUSE(6) arbeitet genau wie MOUSE(5), liefert nur jeweils 
die vertikale y-Koordinate. 
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Beispiel! CheckMouse' 

I F MOUSEC0) = 0 THEN CheckMouse 
I F ABS( X-MOUSEC 1) ) > 2 THEN MovePicture 
IF ABSCY—MOUSEC 2 ) ) < 3 THEN CheckMouse 
MovePicture: 

PUT (X,Y),P 

X=MOUSE(1):Y=M0USE(2) 

PUT ( X, Y ) , P 
GOTO CheckMouse 

Bei diesem Beispiel wird die Mausbewegung überwacht. 
Wenn die Maus bei gedrückter Auswahltaste bewegt wird, 
wird ein grafisches Objekt, das im Feld P gespeichert ist, in 
eine neue Position bewegt. 

Anmerkungen: • Mit der MOUSE-Funktion kann nicht die rechte Maustaste 
(Menü-Taste) überwacht werden. Dazu dient vielmehr die 
MENU-Funktion (s. dort) 



9-136 


Befehle, Anweisungen und Funktionen 


MOUSE 

Formate: 

Bedeutung: 

Beispiel: 

Anmerkungen: 


ON/OFF/STOP-Anweisungen 


MOUSE ON 
MOUSE OFF 
MOUSE STOP 

Die Unterbrechungsreaktionsfähigkeit bei Betätigung der Aus¬ 
wahltaste (linke Taste) der Maus durch den Anwender wird 
aktiviert oder inaktiviert. 

Siehe MENU ON/OFF/STOP-Anweisungen. 

• Die Anweisung MOUSE ON muß ausgeführt werden, um eine 
Unterbrechungsverzweigung bei Betätigung der Auswahlta¬ 
ste der Maus durch den Anwender zu erreichen. 

• Nach MOUSE OFF kann bei Auswahltastenbetätigung nicht 
mehr programmiert verzweigt werden. 

• Nach MOUSE STOP speichert Amiga Basic eine Auswahlta¬ 
stenbetätigung durch den Anwender, unterbricht das Pro¬ 
gramm mit einer Verzweigung aber erst, sobald eine MOUSE 
ON-Anweisung gegeben wird. 

• Weitere Hinweise finden Sie bei der MOUSE-Funktion und 
ON MOUSE-Anweisung sowie im Kapitel 6.4. 
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NAME-Befehl 


Format: NAME Dateiangabe AS Dateiname 

Bedeutung: Es wird einer Disketten- oder Festplattendatei ein neuer Name 

zugewiesen. 

Dateiangabe Ein Zeichenkettenausdruck für eine Dateispezifi¬ 
kation, wie in Kapitel 5.2 beschrieben. 

Dateiname Ein Zeichenkettenausdruck für einen gültigen Datei¬ 
namen, wie in Kapitel 5.2 beschrieben. 

Beispiel: NAME “ADRESSEN.TXT“ AS “ANSCHR.TXT“ 

Die Datei ADRESSEN.TXT auf der Diskette im aktuellen Laufwerk 
erhält den Namen ANSCHR.TXT. 


Anmerkungen: • Es wird eine Fehlermeldung angezeigt, wenn die umzube¬ 
nennende Datei auf dem spezifizierten Laufwerk nicht exi¬ 
stiert oder wenn der neue Name auf diesem Laufwerk bereits 
für eine andere Datei vergeben ist. 

• Fehlt die Angabe eines Laufwerks (Diskette oder Festplatte), 
so wird das im AmigaDOS voreingestellte Laufwerk ange¬ 
nommen. 
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NEW-Befehl 


Format: NEW 

Bedeutung: Das im Hauptspeicher befindliche Programm wird zusammen mit 

all seinen Variablen und dem List-Fenster gelöscht. 

Beispiel: : PRINT a$ 

Commodore PC 

Ok 

NEW 

Ok 

PRINT 

Ok 

Anmerkungen: # Nach der Ausführung von NEW kehrt der Interpreter immer 
in die Befehlsebene (Direktmodus) zurück, nachdem das 
Ausgabefenster gelöscht wurde. 

• Mit der Ausführung von NEW werden alle geöffneten Dateien 
geschlossen sowie eine ggf. eingeschaltete Programmab¬ 
laufüberwachung (s. TRON-Befehl) ausgeschaltet. 

• NEW kann auch aus dem Project-Menü gewählt werden. 

• Befindet sich zum Zeitpunkt der Ausführung des NEW-Be- 
fehls ein Programm im Speicher, daß nach dem Laden 
verändert wurde oder noch nicht gespeichert wurde, so wird 
der Anwender in einem Komunikationsfenster aufgefordert, 
zu entscheiden, ob er dieses Programm vor der Ausführung 
von NEW auf Disk speichern will oder nicht. 

• NEW verändert nicht die Position oder Größe von Fenstern. 
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NEXT-Anweisung 


Siehe FOR-Anweisung. 
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OBJECT.AX- und OBJECT.AY-Anweisungen 


Format: OBJECT.AX Objekt,Wert 

OBJECT.AY Objekt, Wert 


Bedeutung: Definiert die Beschleunigung eines grafischen Objektes (Bob 

oder Sprite) in X- bzw, Y-Richtung 

Objekt Ein ganzzahliger Ausdruck, dessen Wert größer als 0 sein 
muß, und der der Objekt-Kennung in der OBJECT.SHAPE-Anwei- 
sung (s. dort) entspricht. 

Wert Einganzzahliger Ausdruck, dessen Wert größer als 1 sein 
muß, und der die Beschleunigungsrate in Bildpunkten pro Se¬ 
kunde angibt. 


Beispiel: 


Siehe OBJECT.SHAPE-Anweisung. 
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OBJECT.CLIP-Anweisung 


Format: OBJECT.CLIP (x1,y1)-(x2,y2) 


Bedeutung: Definiert ein Rechteck, dessen Grenzen die Begrenzung beim 

Zeichnen eines Objektes (Bob oder Sprite) darstellen. Voreinge¬ 
stellt ist hier das aktuelle Ausgabe-Fenster. 

x1,y1 Koordinaten der oberen linken Ecke des Rechtecks. 

x2,y2 Koordinaten der unteren rechten Ecke des Rechtecks. 

Anmerkungen: • ln Kapitel 7 wird beschrieben, wie Objekte mit Hilfe des 
Objekt-Editors erzeugt werden können. Der Objekt-Editor 
ist ein Amiga Basic-Programm. 

• Wenn Sie die Größe des Ausgabefensters durch Ziehen des 
Größen-Symbols mit der Maus verändern, werden die 
Grenzen des Objektbereiches, wie sie mit der letzten 
OBJECT.CLIP-Anweisung definiert werden, nicht verändert. 
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OBJECT.CLOSE-Anweisung 


Format: OBJECT.CLOSE [Objek^ Objekt ...]] 

Bedeutung: Gibt den von einem, mehreren oder allen Objekten belegten 

Speicherplatz wieder frei, wenn die angegebenen Objekte nicht 
mehr benötigt werden. 

Objekt Ein ganzzahliger Ausdruck, dessen Wert größer als 0 sein 
muß, und der der Objekt-Kennung in der OBJECT.SHAPE- 
Anweisung (s. dort) entspricht. Objekt bezeichnet das Objekt im 
aktuellen Ausgabefenster, das nicht mehr benötigt wird. Wenn 
keine Objekt-Kennungen angegeben werden, wird der für alle 
Objekte des aktuellen Ausgabefensters reservierte Speicherplatz 
wieder freigegeben. 
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OBJECT.HIT-Anweisung 


Format: OBJECT HIT Objek^,Se/bs%Fremd\ 


Bedeutung: Legt fest, ob bei einer Kollision von Objekt mit der Fensterbe¬ 

grenzung oder mit einem anderen Objekt ein Unterbrechungs¬ 
ereignis, das mit der ON COLLISION GOSUB-Anweisung (s. 
dort) programmiert verarbeitet werden kann, stattfinden soll 
oder nicht. 

Objekt Ein ganzzahliger Ausdruck, dessen Wert größer als 0 
sein muß, und der der Objekt-Kennung in der OBJECT.SHA- 
PE-Anweisung (s. dort) entspricht. 

Selbst Ein ganzzahliger Wert zwischen 1 und 65535, der das 
Dezimaläquivalent einer 16-Bit-Maske darstellt. Jedes Bit dieser 
Maske korrespondiert zu dem entsprechenden Bit der Stoß- 
Maske (s. unten). 

Stoß Ein ganzzahliger Wert zwischen 0 und 65535, der das 
Dezimaläquivalent einer 16-Bit-Maske darstellt. Ist das nieder¬ 
wertigste Bit dieser Maske gesetzt, so bedeutet dies, daß bei 
einer Kollision des zugehörigen Objekts mit der Fensterbegren¬ 
zung ein COLLISION-Unterbrechungsereignis eintritt, das mit 
einer ON COLLISION GOSUB-Anweisung (s. dort) verarbeitet 
werden kann. Jedes andere gesetzte Bit dieser Maske bedeutet, 
daß bei einer Kollision dieses Objekts mit einem anderen Objekt, 
in dessen Se/ösf-Maske an der entsprechenden Stelle ebenfalls 
ein Bit gesetzt ist, ein COLLISION-Unterbrechungsereignis ein¬ 
tritt. 

Kollidiert dagegen Objekt mit einem anderen Objekt, wobei die 
logische UND-Verknüpfung von Selbst mit der Stoß-Maske des 
anderen Objektes den Wert Null ergibt, so tritt kein Unterbre¬ 
chungsereignis ein; die beiden Objekte können sich also ohne 
Reaktion gegenseitig durchdringen. 



9-144 


Beispiel: 


Anmerkungen: 
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OBJECT.SHAPE l,Asteroi4$ 

OBJECT. SHAPE 2, Schiff $ 

OBJECT : SHAPE 3, Geschosst 

OBJECT.HIT 1,8.7 ’ ko IIidiert mit Rand, Schiff, 

Geschoss 

OBJECT .HIT 2,2,9 * ko 1 I idiert mit Rand, flstero id 

OBJECT.HIT 3,4,9 ' ko 11idiert mit Rand, As teroid 

• Voreinstellungsmäßig kollidieren alle Objekte miteinander 
und mit der Fensterbegrenzung. 

• Treffen zwei Objekte aufeinander, so wird die Selbst -Maske 
des linken oder oberen Objektes mit der SfoiJ-Maske des 
rechten oder unteren Objektes logisch UND-verknüpft. Ist 
das Ergebnis Null, tritt kein Unterbrechungsereignis ein, ist 
es von Null verschieden, tritt ein Unterbrechungsereignis ein 
(s.a. COLLISION- und ON COLLISION GOSUB-Anweisun- 
gen sowie Kapitel 6.4) 

• Weitere Informationen zur Definition der Kollisionsmasken 
bei grafischen Objekten finden Sie im AmigaROM-Hand- 
buch. 
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OBJECT.ON- und 
OBJECT.OFF-Anweisungen 


Format: OBJECT.ON [Objekt^,Objekt ...]] 

OBJECT.OFF [Objekt[,Objekt ...]] 

Bedeutung: Diese beiden Anweisungen machen ein Objekt, mehrere oder 

alle Objekte im aktuellen Ausgabefenster sichtbar (OBJECT.ON) 
oder unsichtbar (OBJECT.OFF). 

Objekt Ein ganzzahliger Ausdruck, dessen Wert größer als 0 
sein muß, und der der Objekt-Kennung in der OBJECT.SHAPE- 
Anweisung (s. dort) entspricht. Objekt bezeichnet das Objekt im 
aktuellen Ausgabefenster, das sichtbar oder unsichtbar ge¬ 
macht werden soll. Wird Objekt nicht angegeben, so werden alle 
Objekte im aktuellen Ausgabefenster sichtbar oder unsichtbar 
gemacht. 


Beispiel: Siehe OBJECT.SFIAPE-Anweisung. 


Anmerkungen: 0 War ein mit der OBJECT.ON-Anweisung sichtbar ge¬ 
machtes Objekt vorher mit einer OBJECT.START-Anwei- 
sung (s. dort) in Bewegung gesetzt worden, so bewegt es 
sich nach der Sichtbarmachung weiter. 

0 Die OBJECT.OFF-Anweisung hält außerdem ein ggf. vorher 
mit OBJECT.START in Bewegung gesetztes Objekt an, wo¬ 
durch auch zukünftige Kollisionen unterbunden werden. 
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OBJECT.PLANES-Anweisung 


Format: OBJECT.PLANES Objekt [,Bitebene] [, Ebene-Ein-A us] 

Bedeutung: Definiert zwei 8-Bit-Masken, mit denen die Farbdarstellung von 

Bobs (s.a. Kapitel 7.4) beeinflußt werden kann. 

Objekt Ein ganzzahliger Ausdruck, dessen Wert größer als 0 
sein muß, und der der Objekt-Kennung in der OBJECT.SHAPE- 
Anweisung (s. dort) entspricht. Objekt bezeichnet das Objekt im 
aktuellen Ausgabefenster, für das die Farbdarstellung geändert 
werden soll. 

Bitebene Ein ganzahliger Ausdruck, dessen Wert zwischen 0 
uns 255 liegen muß, und der das Dezimaläquivalent einer 8—Bit- 
Maske darstellt. Diese Maske legt fest, in welchen Bitebenen das 
System die Abbildung des durch Objekt bezeichneten Bobs 
zeichnen soll. 

Ebene-Ein-Aus Ein ganzahliger Ausdruck, dessen Wert zwi¬ 
schen 0 und 255 liegen muß, und der das Dezimaläquivalent einer 
8-Bit-Maske darstellt. Diese Maske legt fest, wie die Bildpunkte 
in den einzelnen Bitebenen, die nicht von der Maske Bitebene 
beeinflußt werden, dargestellt werden sollen. 

Anmerkungen: • Voreingestellt sind für beide Masken die Werte, die der 
Objekt-Editor (s. Kapitel 7) festlegt. 


• Im AmigaROM-Handbuch finden Sie detaillierte Informatio¬ 
nen zu diesen beiden Masken. 
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OBJECT.PRIORITY-Anweisung 


Format: OBJECT.PRIORITY Objekt.Prior 

Bedeutung: Setzt die Priorität, mit der ein spezifiziertes Bob im Vergleich zu 

anderen Bobs mit niedrigerer oder höherer Priorität im aktuellen 
Ausgabefenster vom System gezeichnet wird. 

Objekt Ein ganzzahliger Ausdruck, dessen Wert größer als 0 
sein muß, und der der Objekt-Kennung in der OBJECT.SFIAPE- 
Anweisung (s. dort) entspricht. Objekt bezeichnet das Bob im 
aktuellen Ausgabefenster, für das die Abbildungspriorität ge¬ 
setzt werden soll. 

Prior Ein ganzzahliger Ausdruck, dessen Wert zwischen -32768 
und +32767 liegen muß, und der die Priorität, mit der das 
System das Abbild eines Bobs im Ausgabefenster aufbaut, 
festlegt. Je höher dieser Wert ist, umso höher ist die Priorität. 
Beispielsweise wird ein Bob mit einer Priorität von 8 vor anderen 
Objekten mit Prioritäten von 0 bis 7 abgebildet. 

Anmerkungen: • Bobs mit gleicher Priorität werden in zufälliger Reihenfolge 
abgebildet. 
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OBJECT.SHAPE-Anweisung 


Formate: 

Syntax 1: OBJECT.SHAPE Objekt,Definition 

Syntax 2: OBJECT.SHAPE Objekt 1,Objekt 2 

Bedeutung: 

Syntax 1: Definiert Form, Farben, Ort und weitere Attribute für ein grafi¬ 

sches Objekt (Bob oder Sprite), das im aktuellen Ausgabefen¬ 
ster beliebig bewegt werden kann. Einzelheiten zu Bobs und 
Sprites finden Sie im Kapitel 7 sowie im AmigaROM-Handbuch 
im Abschnitt über grafische Animation. 

Objekt Ein ganzzahliger Wert, der größer als 0 sein muß und der 
dem zu definierenden Objekt zugeordnet wird. Mit dieser Ken¬ 
nung nehmen die anderen OBJECT.-Anweisungen auf das je¬ 
weilige Objekt Bezug. 

Definition Ein Zeichenkettenausdruck, der die statischen Attri¬ 
bute wie Größe, Form und Farbe des Objektes definiert. Der 
Objekt-Editor, den Sie in der BasicDemos-Schublade auf der 
Extras-Diskette finden, und der in Amiga Basic geschrieben ist, 
setzt diese Zeichenkette zusammen (s. Kapitel 7). 

Syntax 2: Die Form von Objekt 2 wird auf Objekt 1 kopiert und damit ein 

neues Objekt erzeugt. Da beide Objekte einen beträchtlichen 
Speicherbreich gemeinsam belegen, kann der Speicherbedarf 
für multiple Objekte mit der Syntax 2 reduziert werden. 

Obwohl Objekt 1 und Objekt 2 Speicherplatz gemeinsam bele¬ 
gen, können ihnen mit den anderen OBJECT-Anweisungen 
jeweils unterschiedliche Attribute gegeben werden. Aus diesem 
Grund initialisiert Amiga Basic die OBJECT.X, OBJECt.Y, 
OBJECT.VX, OBJECT.VY, OBJECT.AX und OBJECT.AY zuge¬ 
wiesenen Werte mit 0. 
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Beispiel: 


OPEN "Ba I I*’ FOR I NPUT AS 1 
OBJECT.SHAPE 1, INPUT$<LOFC1), 1) 

Bei diesem Beispiel enthält die Datei Ball, die z.B. mit dem 
Objekt-Editor (s. Kapitel 7) erstellt wurde, die statischen Attribu¬ 
te wie Größe, Form und Farben. 

Das folgende Beispiel zeigt, wie das im obigen Beispiel mit Hilfe 
der Datei Ball definierte Objekt bewegt werden kann, und wie 
Kollisionen programmiert verarbeitet werden können. 

WINDOW 4,"Animation*', <310,95)-C580, 170), 15 
ON COLLISION GOSUB Abprall len 
COLLISION ON 

OPEN "Ball" FOR INPUT AS 1 
OBJECT.SHAPE 1, INPUT$CLOF<1), 1) 

CLOSE 1 
OBJECT.X 1, 10 
OBJECT.Y 1,50 
OBJECT.OX 1, 30 
OBJECT.OY 1,30 
OBJECT.ON 
OBJECT.START 
WHILE 1 
SLEEP 
WEND 


Abpra1 len - 

MerkF=WINDOW(1) 

WINDOW 4 
i = COLLISIONC0) 

IF i = 0 THEN RETURN 
j=COLLISIONC i ) 

IF j = -2 OR j = —4 THEN 

* Objekt pra I It gegen I inken oder rechten Rand 
OBJECT.0X1,-OBJECT.OXCi) 

ELSE 

* Objekt prallt gegen oberen oder unteren Rand 
OBJECT.OY i »-OBJECT.OY Ci) 

END IF 

OBJECT.START 
WINDOW MerkF 
RETURN 
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OBJECT.START- und 
OBJECT.STOP-Anweisungen 


Formate: OBJECT.START [ObjektObjekt ...]] 

OBJECT.STOP [Objekt,,Objekt ..]] 

Bedeutung: Diese beiden Anweisungen setzen ein Objekt, mehrere oder 

alle Objekte im aktuellen Ausgabefenster in Bewegung 
(OBJECT.START) oder halten sie an (OBJECT.STOP). 

Objekt Ein ganzzahliger Ausdruck, dessen Wert größer als 0 
sein muß, und der der Objekt-Kennung in der OBJECT.SHAPE- 
Anweisung (s. dort) entspricht. Objekt bezeichnet das Objekt im 
aktuellen Ausgabefenster, das in Bewegung gesetzt oder ange¬ 
halten werden soll. Wird Objekt nicht angegeben, so werden alle 
Objekte im aktuellen Ausgabefenster in Bewegung gesetzt oder 
angehalten. 


Beispiel: Siehe OBJECT.SHAPE-Anweisung. 


Anmerkungen: • Kollidieren zwei Objekte miteinander, so führt Amiga Basic 
die OBJECT.STOP-Anweisung für beide Objekte automa¬ 
tisch aus. 

• Kollidiert ein Objekt mit der Fensterbegrenzung, so führt 
Amiga Basic für dieses Objekt die OBJECT.STOP-Anwei¬ 
sung automatisch aus. 
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OBJECT.VX- und OBJECT.VY-Anweisungen 


Formate: OBJECT.VX Objekt,Geschw 

OBJECT.VY Objekt,Geschw 

Bedeutung: Definiert für ein angegebenes Objekt die Geschwindigkeit in X- 

oder Y-Richtung. 

Objekt Ein ganzzahliger Ausdruck, dessen Wert größer als 0 
sein muß, und der der Objekt-Kennung in der OBJECT.SHAPE- 
Anweisung (s. dort) entspricht. Objekt bezeichnet das Objekt im 
aktuellen Ausgabefenster, für das die angegebene Geschwin¬ 
digkeit gelten soll. 

Geschw Ein ganzzahliger Ausdruck, dessen Wert zwischen 
-32768 und 32767 liegen muß, und der die Geschwindigkeit in 
Bildpunkten pro Sekunde definiert. 

Beispiel: Siehe OBJECT.SHAPE-Anweisung. 


Anmerkungen: • Objekt können auch beschleunigt werden. Siehe dazu 
OBJECT.AX- und OBJECT.AY-Anweisungen. 
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OBJECT. VX- und OBJECT.VY-Funktionen 


Formate: v= OBJECT.VX ( Objekt) 

v= OBJECT.VY ( Objekt) 

Bedeutung: Liefert für ein angegebenes Objekt die Geschwindigkeit in X- 

oder Y-Richtung als ganzzahligen Wert in Bildpunkten/Sekunde. 

Objekt Ein ganzzahliger Ausdruck, dessen Wert größer als 0 
sein muß, und der der Objekt-Kennung in der OBJECT.SHAPE- 
Anweisung (s. dort) entspricht. Objekt bezeichnet das Objekt im 
aktuellen Ausgabefenster, dessen Geschwindigkeit abgefragt 
werden soll. 


Beispiel: 


Siehe OBJECT.SHAPE-Anweisung. 
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OBJECT.X- und OBJECT.Y-Anweisungen 


Formate: OBJECT.X Objekt,x 

OBJECT.Y Objekt,y 

Bedeutung: Plaziert ein angegebenes Objekt bei einer angegebenen Position 

im aktuellen Ausgabefenster (z.B. als Ausgangspunkt für Bewe¬ 
gungen. Die angegebenen Koordinaten bezeichnen die linke 
obere Ecke des Rechteckes, in dem das Objekt definiert ist. 

Objekt Ein ganzzahliger Ausdruck, dessen Wert größer als 0 
sein muß, und der der Objekt-Kennung in der OBJECT.SHAPE- 
Anweisung (s. dort) entspricht. Objekt bezeichnet das Objekt im 
aktuellen Ausgabefenster, das bei der angegebenen Position 
plaziert werden soll. 

x,y Ganzzahlige Ausdrücke, deren Werte die Koordinaten der 
oberen linken Ecke des Objekt-Rechteckes bezeichnen. 

Beispiel: Siehe OBJECT.SHAPE-Anweisung. 
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OBJECT.X- und OBJECT.Y-Funktionen 


Formate: v= OBJECT.X (Objekt) 

v= OBJECT.Y ( Objekt) 

Bedeutung: Liefert die Koordinaten der linken oberen Ecke des Rechteckes, 

in dem das angegebene Objekt definiert ist, bei der aktuellen 
Position. 

Objekt Ein ganzzahliger Ausdruck, dessen Wert größer als 0 
sein muß, und der der Objekt-Kennung in der OBJECT.SHAPE- 
Anweisung (s. dort) entspricht. Objekt bezeichnet das Objekt im 
aktuellen Ausgabefenster, dessen Position abgefragt werden 
soll. 
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OCT$-Funktion 


Format: v$ = OCT$(/j) 

Bedeutung: Es wird eine Zeichenkette übergeben, die die oktale Darstellung 

des Wertes des numerischen Ausdruckes n enthält. 


n Beliebiger numerischer Ausdruck, dessen ganzzahliger Wert 
gewandelt wird und der im Bereich zwischen -32768 und 65535 
liegen muß. Bei negativen Werten wird die Zweier-Komple- 
ment-Darstellung benutzt. 


Beispiel: x=z3.4:y=-256 

PRINT X; OCT$CX), Y; OCT$CY) 

ergibt im Ausgabefenster die Anzeige 

23.4 27 -256 177400 

Ok 

Anmerkungen: • Vor der Wandlung werden Dezimalstellen rechts vom Dezi¬ 
malpunkt abgeschnitten. 


• Die Wandlung in hexadezimale Darstellung kann mit der 
HEX$-Funktion (s. dort) erreicht werden. 
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ON BREAK-Anweisung 


Format: ON BREAK GOSUB Marke 


Bedeutung: Das Programm verzweigt zu der angegebenen Zeile, sobald die 

Tastenkombinationen CTRL-C oder Amiga-. (Programmunter¬ 
brechung) gedrückt werden, oder Stop aus dem Run-Menü 
gewählt wird. 

Marke Eine gültige Zeilennummer oder alphanumerische 
Sprungmarke, zu der verzweigt werden soll, sobald das Pro¬ 
gramm unterbrochen wird. Wird für Marke der Wert 0 (Null) 
angegeben, wird die Unterbrechungsreaktionsfähigkeit inakti¬ 
viert. 

Beispiel: on break gosub 100 

BREAK ON 
10 GOTO 10 


100 PRINT "Unterbrechung nicht erlaubt ! " 

RETURN 

Anmerkungen: • Um die ON BREAK-Anweisung zu aktivieren, muß außerdem 
die Anweisung BREAK ON (s. dort) ausgeführt werden. 
Danach prüft Amiga Basic, falls die in der ON BREAK-Anwei¬ 
sung angegebene Marke nicht 0 war, vor der Ausführung 
jeder Anweisung, ob CTRL-C gedrückt oder Stop aus dem 
Run-Menü gewählt wurde. Ist dies des Fall, so wird zu der 
durch Marke spezifizierten Unterbrechungsroutine ver¬ 
zweigt. 

• Amiga Basic führt bei einer Unterbrechungsverzweigung 
außerdem automatisch BREAK STOP (s.a. dort) aus, um 
Unterbrechungsschachtelung zu vermeiden. 
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• Die Ausführung der RETURN-Anweisung in der Unterbre¬ 
chungsroutine bewirkt die automatische Ausführung der 
BREAK ON-Anweisung (s.a. dort), es sei denn, die Unter¬ 
brechungsroutine enthält die Anweisungen BREAK OFF 
oder BREAK STOP. 

• Man kann durch Angabe einer Marke in der RETURN-Anwei¬ 
sung der Unterbrechungsroutine zu einer bestimmten Pro¬ 
grammzeile des Hauptprogramms zurückverzweigen. Hier 
ist jedoch Vorsicht geboten, da ggf. bei der Unterbrechung 
aktive FOR-, GOSUB- oder WHILE-Anweisungen aktiv blei¬ 
ben und dadurch der Stapelspeicher von Amiga Basic in 
Unordnung gebracht werden kann. 

• Weitere Hinweise zur Verarbeitung von Unterbrechungs¬ 
ereignissen finden Sie im Kapitel 6.4. 
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ON COLLISION-Anweisung 


Format: ON COLLISION GOSUB Marke 


Bedeutung: Das Programm verzweigt zu der angegebenen Zeile, sobald ein 

grafisches Objekt (Bob oder Sprite; s. dazu Kapitel 7.4) mit der 
Begrenzung des aktuellen Ausgabefensters oder einem anderen 
Objekt kollidiert. 

Marke Eine gültige Zeilennummer oder alphanumerische 
Sprungmarke, zu der verzweigt werden soll, sobald eine Kollision 
stattgefunden hat. Wird für Marke der Wert 0 (Null) angegeben, 
wird die Unterbrechungsreaktion inaktiviert. 

Beispiel: Siehe OBJECT.SHAPE-Anweisung. 


Anmerkungen: • Um die ON COLLISION-Anweisung zu aktivieren, muß au¬ 
ßerdem die Anweisung COLLISION ON (s. dort) ausgeführt 
werden. Danach prüft Amiga Basic, falls die in der ON 
COLLISION-Anweisung angegebene Marke nicht 0 war, vor 
der Ausführung jeder Anweisung, ob eine Objektkollision 
stattgefunden hat. Ist dies des Fall, so wird zu der durch 
Marke spezifizierten Unterbrechungsroutine verzweigt. 


• Amiga Basic führt bei einer Unterbrechungsverzweigung 
außerdem automatisch COLLISION STOP (s. dort) aus, um 
Unterbrechungsschachtelung zu vermeiden. 

• Die Ausführung der RETURN-Anweisung in der Unterbre¬ 
chungsroutine bewirkt die automatische Ausführung der 
COLLISION ON-Anweisung (s. dort), es sei denn, die Unter¬ 
brechungsroutine enthält die Anweisungen COLLISION OFF 
oder COLLISION STOP. 
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• Man kann durch Angabe einer Marke in der RETURN-Anwei- 
sung der Unterbrechungsroutine zu einer bestimmten Pro¬ 
grammzeile des Hauptprogramms zurückverzweigen. Hier 
ist jedoch Vorsicht geboten, da ggf. bei der Unterbrechung 
aktive FOR-, GOSUB- oder WHILE-Anweisungen aktiv blei¬ 
ben und dadurch der Stapelspeicher von Amiga Basic in 
Unordnung gebracht werden kann. 

• Weitere Hinweise zur Verarbeitung von Unterbrechungs¬ 
ereignissen finden Sie im Kapitel 6.4. 
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ON ERROR-Anweisung 


Format: ON ERROR GOTO Marke 

Bedeutung: Das Programm verzweigt zu einer angegebenen Zeile sobald der 

Amiga Basic eine Fehlermeldung absetzen will. 

Marke Eine gültige Programmzeilennummer oder alphanumeri¬ 
sche Sprungmarke, bei der die Unterbrechungsroutine beginnt. 
Wird für Marke 0 (Null) angegeben, so wird die Fehlerunterbre¬ 
chungsreaktionsfähigkeit inaktiviert. Nachfolgende Fehler füh¬ 
ren dann zum Programmabbruch und zur Fehleranzeige auf dem 
Bildschirm. 


Beispiel: siehe ERR-Variable. 

Anmerkungen: • Steht in der Fehlerbehandlungsroutine die Anweisung ON 
ERROR GOTO 0, so wird das Programm beendet und die 
Fehlermeldung angezeigt. Dies erlaubt eine Programmbeen¬ 
digung, falls die Fehlerursache mit Programmitteln nicht 
behoben werden kann. 

• Da die Fehlerbehandlungsroutine nicht selbst unterbrochen 
werden kann, wird das Programm abgebrochen, wenn wäh¬ 
rend der Fehlerbearbeitung ein weiterer Fehler auftritt. 

• Existiert die in der Anweisung angegebene Zeilennummer 
nicht, so wird der Fehler 


Undefined 1 ine number 


(nicht definierte Zeilennummer) angezeigt. 

• Um aus der Fehlerbehandlungsroutine zurück ins Hauptpro¬ 
gramm zu verzweigen, wird die RESUME-Anweisung (s. 
dort) verwendet. 
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ON... 

ON... 


Formate: 

Bedeutung: 


Beispiel 1: 


GOSUB- und 
GOTO-Anweisungen 


ON n GOSUB Marke^, Marke]... 

ON n GOTO Marke[,Marke]... 

Das Programm verzweigt abhängig vom Wert des ganzzahligen 
Ausdruckes n zu der Zeile, deren Nummer oder Marke an nter 
Position in der Liste der spezifizierten Marken steht. 

n Beliebiger ganzahliger Ausdruck, dessen Wert zwischen 0 
und 255 liegen muß. Ist der Ausdruck nicht ganzzahlig, so wird 
sein Wert gerundet. 

Marke Eine gültige Programmzeilennummer oder alphanumeri¬ 
sche Sprungmarke, zu der verzweigt werden soll. Bei der 
ON . .. GOSUB-Anweisung muß dies eine Zeilennummer oder 
Sprungmarke einer Subroutine sein. 


Warte: 

Z$= I NKEY$ : I F Z$ = ,,,p THEN Warte 
IF OR Z$>"C" THEN Warte 

ON ftSCCZ$)-64 GOSUB Subl,Sub2,Sub3 

Subl: 

REM Beginn 1. Subroutine 


RETURN 


Sub2: 

REM Beginn 2. Subroutine 


RETURN 


Sub3: 

REM Beginn 3. Unterprogramm 


RETURN 




9-162 


Befehle, Anweisungen und Funktionen 


Abhängig vom Zeichencode einer der drei Tasten A, B oder C 
verzweigt das Programm in ein jeweils anderes Unterprogramm. 
Die jeweilige RETURN-Anweisung verzweigt zurück zu der auf 
die ON .. . GOSUB-Anweisung folgenden Anweisung. 

Beispiel 2 : iee on x-z goto 200,300,400 

110 PRINT "Keine Verzweigung" 

Das Programm verzweigt für 

X = 3 nach Zeile 200 
X = 4 nach Zeile 300 
X = 5 nach Zeile 400 
X>5 nach Zeile 110 
X<3 nach Zeile 110 

Anmerkungen: • Liegt /»außerhalb des gültigen Bereiches, wird die Fehler¬ 
meldung 


I Ileydl function ca I I 


(unerlaubter Funktionsaufruf) angezeigt. 
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ON MENU-Anweisung 


Format: ON MENU GOSUB Marke 


Bedeutung: Das Programm verzweigt zu der angegebenen Zeile, sobald mit 

der Maus ein Menü aus der Menü-Leiste gewählt wird. 

Marke Eine gültige Zeilennummer oder alphanumerische 
Sprungmarke, zu der verzweigt werden soll, sobald ein Menü 
gewählt wird. Wird für Marke der Wert 0 (Null) angegeben, wird 
die Unterbrechungsreaktionsfähigkeit inaktiviert. 

Beispiel: Siehe MENU-Anweisung 


Anmerkungen: • Um die ON MENU-Anweisung zu aktivieren, muß außerdem 
die Anweisung MENU ON (s. dort) ausgeführt werden. 
Danach prüft Amiga Basic, falls die in der ON MENU-Anwei¬ 
sung angegebene Marke nicht 0 war, vor der Ausführung 
jeder Anweisung, ob ein Menü in der Menüleiste gewählt 
wurde. Ist dies des Fall, so wird zu der durch Marke 
spezifizierten Unterbrechungsroutine verzweigt. 

• Amiga Basic führt bei einer Unterbrechungsverzweigung 
außerdem automatisch MENU STOP (s. dort) aus, um Unter- 
brechungsschachtelung zu vermeiden. 

• Die Ausführung der RETURN-Anweisung in der Unterbre¬ 
chungsroutine bewirkt die automatische Ausführung der 
MENU ON-Anweisung (s. dort), es sei denn, die Unterbre¬ 
chungsroutine enthält die Anweisungen MENU OFF oder 
MENU STOP. 


• Man kann durch Angabe einer Marke in der RETURN-Anwei¬ 
sung der Unterbrechungsroutine zu einer bestimmten Pro¬ 
grammzeile des Hauptprogramms zurückverzweigen. Hier 
ist jedoch Vorsicht geboten, da ggf. bei der Unterbrechung 
aktive FOR-, GOSUB- oder WHILE-Anweisungen aktiv blei¬ 
ben und dadurch der Stapelspeicher von Amiga Basic in 
Unordnung gebracht werden kann. 

• Weitere Hinweise zur Verarbeitung von Unterbrechungs¬ 
ereignissen finden Sie im Kapitel 6.4. 




9-164 Befehle, Anweisungen und Funktionen 

ON MOUSE-Anweisung 


Format: ON MOUSE GOSUB Marke 

Bedeutung: Das Programm verzweigt zu der angegebenen Zeile, sobald die 

Auswahl-Taste (linke Taste) der Maus gedrückt wird. 

Marke Eine gültige Zeilennummer oder alphanumerische 
Sprungmarke, zu der verzweigt werden soll, sobald die Auswahl¬ 
taste der Maus gedrückt wird. Wird für Marke der Wert 0 (Null) 
angegeben, wird die Unterbrechungsreaktionsfähigkeit inakti¬ 
viert. 

Beispiel: Siehe MENU-Anweisung 

Anmerkungen: • Um die ON MOUSE-Anweisung zu aktivieren, muß außer¬ 
dem die Anweisung MOUSE ON (s. dort) ausgeführt werden. 
Danach prüft Amiga Basic, falls die in der ON MOUSE-An¬ 
weisung angegebene Marke nicht 0 war, vor der Ausführung 
jeder Anweisung, ob die Auswahltaste der Maus gedrückt 
wurde. Ist dies des Fall, so wird zu der durch Marke 
spezifizierten Unterbrechungsroutine verzweigt. 

• Amiga Basic führt bei einer Unterbrechungsverzweigung 
außerdem automatisch MOUSE STOP (s. dort) aus, um 
Unterbrechungsschachtelung zu vermeiden. 

• Die Ausführung der RETURN-Anweisung in der Unterbre¬ 
chungsroutine bewirkt die automatische Ausführung der 
MOUSE ON-Anweisung (s. dort), es sei denn, die Unterbre¬ 
chungsroutine enthält die Anweisungen MOUSE OFF oder 
MOUSE STOP. 

• Man kann durch Angabe einer Marke in der RETURN-Anwei¬ 
sung der Unterbrechungsroutine zu einer bestimmten Pro¬ 
grammzeile des Hauptprogramms zurückverzweigen. Hier 
ist jedoch Vorsicht geboten, da ggf. bei der Unterbrechung 
aktive FOR-, GOSUB- oder WHILE-Anweisungen aktiv blei¬ 
ben und dadurch der Stapelspeicher von Amiga Basic in 
Unordnung gebracht werden kann. 

• Weitere Hinweise zur Verarbeitung von Unterbrechungs¬ 
ereignissen finden Sie im Kapitel 6.4. 
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ON TIMER-Anweisung 


Format: ON TIMER(/>) GOSUB Marke 


Bedeutung: Das Programm verzweigt zu der angegebenen Zeile, sobald eine 

angegebene Zahl von Sekunden verstrichen ist. Die Unterbre¬ 
chung erfolgt alle n Sekunden. 

n Ein beliebiger numerischer Ausdruck, dessen ganzzahliger 
Wert zwischen 1 und 86400 (24 Stunden) liegen muß, und der die 
Zeitspanne in Sekunden definiert, an deren Ende die Unterbre¬ 
chung erfolgen soll. 

Marke Eine gültige Zeilennummer oder alphanumerische 
Sprungmarke, zu der verzweigt werden soll, sobald die angege¬ 
bene Zeit verstrichen ist. Wird für Marke der Wert 0 (Null) 
angegeben, wird die Unterbrechungsreaktionsfähigkeit inakti¬ 
viert. 

Beispiel: ON TIMER(fi0) GOSUB ZeigeZeit 

TIMER ON 


ZeigeZeit: 

ZeiIe=CSRLIN:Spalte=POS(0) 

LOCftTE 1,50:PRI NT TIME$ 

LOCflTE Zeile,Spalte 
RETURN 

Alle 60 Sekunden wird die aktuelle Uhrzeit oben rechts im 
aktuellen Ausgabefenster angezeigt. 

Anmerkungen: • Um die ON TIMER-Anweisung zu aktivieren, muß außerdem 
die Anweisung TIMER ON (s. dort) ausgeführt werden. 
Danach prüft Amiga Basic, falls die in der ON TIMER-Anwei¬ 
sung angegebene Marke nicht 0 war, vor der Ausführung 
jeder Anweisung, ob die angegebene Zeitspanne verstri¬ 
chen ist. Ist dies des Fall, so wird zu der durch Marke 
spezifizierten Unterbrechungsroutine verzweigt. 
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• Amiga Basic führt bei einer Unterbrechungsverzweigung 
außerdem automatisch TIMER STOP (s. dort) aus, um Unter- 
brechungsschachtelung zu vermeiden. 

• Die Ausführung der RETURN-Anweisung in der Unterbre¬ 
chungsroutine bewirkt die automatische Ausführung der 
TIMER ON-Anweisung (s. dort), es sei denn, die Unterbre¬ 
chungsroutine enthält die Anweisungen TIMER OFF oder 
TIMER STOP. 

• Man kann durch Angabe einer Marke in der RETURN-Anwei¬ 
sung der Unterbrechungsroutine zu einer bestimmten Pro¬ 
grammzeile des Hauptprogramms zurückverzweigen. Hier 
ist jedoch Vorsicht geboten, da ggf. bei der Unterbrechung 
aktive FOR-, GOSUB-oderWHILE-Anweisungen aktiv blei¬ 
ben und dadurch der Stapelspeicher von Amiga Basic in 
Unordnung gebracht werden kann. 

• Weitere Hinweise zur Verarbeitung von Unterbrechungs¬ 
ereignissen finden Sie im Kapitel 6.4. 
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OPEN-Anweisung 


Formate: OPEN Dateiang [FOR Modusi\ AS 

[#]Dateinr [LEN = Satzlänge] 

OPEN Modus2,[#\Dateinr,Dateiang 
[,Satzlänge] 

Bedeutung: Es wird eine Datei oder eine Ein-/Ausgabe-Einheit zur Daten¬ 

ein- oder -ausgabe geöffnet. Beide angegebenen Formate sind 
gleichwertig. 

Modusl Als Parameter kann hier ein Zeichenkettenausdruck 
angegeben werden, dessen Wert den Datenübertragungsmodus 
bestimmt und einer der folgenden Ausdrücke sein muß: 

OUTPUT für sequentielle Ausgabe; 

APPEND für sequentielle Ausgabe, die an eine bestehende 
Datei angefügt wird; 

INPUT für sequentielle Eingabe. 

Wird FOR Modusl weggelassen, so wird die Datei für wahlfreien 
Zugriff geöffnet. Die Angaben für Modusl dürfen nicht in Anfüh¬ 
rungszeichen stehen. 

Modus2 Als Parameter kann hier ein beliebiger Zeichenketten¬ 
ausdruck angegeben werden, dessen erstes Zeichen den Daten¬ 
übertragungsmodus bestimmt und eines der folgenden sein 
muß: 

O für sequentielle Ausgabe 

A für sequentielle Ausgabe, die an eine bestehende Datei 
angefügt wird; 

I für sequentielle Eingabe; 

R für Ein-/Ausgabe im wahlfreien Zugriff. 

Dateinr Ein ganzzahliger Ausdruck, dessen Wert zwischen 1 
und 255 liegen muß, und der den Zusammenhang zwischen Datei 
und dateibezogenen Ein-/Ausgabeanweisungen herstellt, so¬ 
lange die Datei offen ist. 
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Beispiel 1: 


Beispiel 2: 


Beispiel 3: 


Dateiang Ein Zeichenkettenausdruck für eine Dateispezifikati¬ 
on, wie in Kapitel 5.2 beschrieben. 

Satzlänge Ein ganzzahliger Ausdruck, der, falls angegeben, 
zwischen 1 und 32767 liegen muß und die Länge eines logischen 
Datensatzes für Dateien mit wahlfreiem Zugriff spezifiziert. Wird 
dieser Parameter bei der OPEN-Anweisung für sequentielle 
Dateien angegeben, so korrespondiert er nicht notwendigerwei¬ 
se mit der Länge eines individuellen Satzes, da sequentielle 
Dateien Sätze unterschiedlicher Länge enthalten können. Hier 
gibt eine ggf. angegebene Satzlänge vor, wieviele Zeichen in den 
Dateipuffer geschrieben werden, ehe dieser auf Disk übertragen 
wird. Je größer also der Puffer ist, umso größer ist auch der 
Speicherbedarf, aber umso schneller wird auch die Datei-Ein-/ 
Ausgabe abgewickelt. Voreingestellt ist eine Länge von 128 
Bytes. 

OPEN "TEXT. TXT" FOR OUTPUT RS #2 

oder 

OPEN "O", #2, "TEXT . TXT” 

Beide Anweisungen öffnen eine sequentielle Ausgabedatei 
TEXT.TXT auf dem aktuellen Diskettenlaufwerk unter der logi¬ 
schen Dateinummer 2. 

OPEN "TEXT.TXT" FOR fiPPEND RS #2 

Der bestehenden sequentiellen Datei TEXT.TXT sollen Daten 
hinzugefügt werden. 

100 OPEN "DF1: INDEX” fiS 1 LEN=512 

oder 

OPEN " R" j 1,"DF1:INDEX",512 

Durch beide gleichwertigen Anweisungen wird die Datei INDEX 
auf der Diskette in Laufwerk DF1: für wahlfreien Zugriff mit einer 
logischen Satzlänge von 512 Bytes geöffnet. 
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Beispiel 4: open ”dfi : uerwoltung/personal/gehalt" 

FOR OUTPUT AS V2 

oder 

PFAD$="DF1:UERWALTUNG/PERSONAL/GEHALT" 

OPEN "O" , »2. PFAD$ 

Es wird eine sequentielle Datei GEHALT im Diskettenunterver¬ 
zeichnis PERSONAL auf der Diskette im Laufwerk DF1: geöffnet. 

Anmerkungen: • Das Öffnen einer sequentiellen Ausgabedatei zerstört alle 
ggf. vorher in dieser Datei abgelegten Daten. Sollen die 
Daten erhalten bleiben, muß die Datei im Modus APPEND 
eröffnet werden. 

• Durch die OPEN-Anweisung wird der Datei oder Ein-/ 
Ausgabe-Einheit ein Puffer zugeordnet und der Pufferzu- 
griffs-Modus festgelegt. 

• Folgenden Ein-/Ausgabeanweisungen, die eine Dateinum¬ 
mer benötigen, muß eine OPEN-Anweisung vorangehen: 

INPUT # PRINT # 

LINE INPUT # PRINT # USING 

GET PUT 

WRITE 

• Disketten- oder Festplattendateien können für sequentiellen 
oder wahlfreien Zugriff geöffnet werden. 

• Drucker können für sequentielle oder wahlfreie Ausgabe 
geöffnet werden. Die Satzlänge wird hier jedoch in jedem Fall 
auf 1 gesetzt. 

• Alle anderen Ein-/Ausgabe-Einheiten können nur für se¬ 
quentielle Ein-/Ausabe geöffnet werden. 

• Der Modus APPEND kann nur bei sequentiellen Disk-Ausga¬ 
bedateien verwendet werden. 
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• Eine Eingabedatei kann unter verschiedenen Dateinummern 
und verschiedenen Modi gleichzeitig geöffnet sein, so daß 
mit verschiedenen Zugriffsarten gearbeitet werden kann. In 
diesem Fall wird jeder Dateinummer ein eigener Puffer 
zugeordnet. 

• Ist eine Datei schon geöffnet, kann sie nicht mehr für 
sequentielle Ausgabe (OUTPUT oder APPEND) geöffnet 
werden. 

• Existiert eine Datei, die für Eingabe geöffnet werden soll, 
nicht, so wird die Fehlermeldung 

File noF found 

(Datei nicht gefunden) angezeigt. 

• Öffnen von nicht existierenden Ausgabedateien führt zur 
Neuanlage dieser Dateien auf der spezifizierten Disk (Disket¬ 
te oder Festplatte). 

• Die Angabe der OPEN-Anweisung mit ungültigen Parame¬ 
tern führt zu der Fehlermeldung 


I llegal funct i cm call 


(unerlaubter Funktionsaufruf). 

• Weitere Einzelheiten zur Disk-Datei-Ein-und Ausgabe sind 
in Kapitel 5 zu finden. 
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OPEN 


Format: 


Bedeutung: 


COM1. .“-Anweisung 


OPEN “COM1 :[Baud\[,Parit\[, Wortl\ 

[,Stopb] u [FOR Modus] AS [#]Dateinr 

Es wird eine Datei für Datenfernübertragung über die 
RS232-Schnittstelle geöffnet. 

Baud Eine ganzzahlige Konstante, die den Wert 110, 150, 300, 
600,1200,1800,2400,4800,9600 oder 19200 haben muß und die 
die Übertragungsgeschwindigkeit in Bits pro Sekunde (Baud) 
angibt. Voreingestellt sind 9600 Baud beim Voreinsteller Prefe- 
rences (s. Amiga-Anwenderhandbuch). Der hier gewählte Wert 
ersetzt den mit dem Voreinsteller Preferences gewählten. 

Parit Eine Buchstabenkonstante, die die Sende- und Emp¬ 
fangsdatenprüfung beschreibt. Gültige Buchstaben sind: 

E Sende- und Empfangsdaten werden auf gerade (even) Bit- 
Parität geprüft. 

O Sende- und Empfangsdaten werden auf ungerade (odd) 
Bit-Parität geprüft. 

N Es wird keine (none) Paritätsprüfung durchgeführt. 
Voreingestellt ist hier der Parameter E. 


Wort! Eine ganzzahlige Konstante aus dem Bereich 5, 6, 7 und 
8, die angibt, aus wievielen Bits ein zu übertragendes oder 
empfangenes Zeichen besteht. Voreingestellt ist hier der Wert 7. 

Stopb Eine ganzzahlige Konstante mit dem Wert 1 oder 2, die 
angibt, wieviele Stop-Bits einem zu übertragenden oder empfan¬ 
genen Zeichen folgen. Voreingestellt ist hier der Wert 2 bei einer 
Baud-Rate von 110 und 1 bei allen anderen Baud-Raten. Wurde 
als Wortlänge 5 gewählt, bedeutet hier der Parameter 2, daß 11/2 
Stop-Bits jedem Datenwort folgen. 
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Beispiel 1: 


Beispiel 2: 


Anmerkungen: 


Modus Eine der beiden Zeichenkettenkonstanten 

OUTPUT für sequentielle Ausgabe, 

INPUT für sequentielle Eingabe. 

Fehlt die Angabe FOR Modus , wird wahlfreie Ein-/Ausgabe 
angenommen. Dieser Modus kann nicht explizit spezifiziert 
werden. 

Dateinr Ein ganzzahliger Ausdruck, dessen Wert eine gültige 
Dateinummer angibt, die in den Anweisungen für Datenfernüber¬ 
tragung verwendet wird. 

OPEN "COM1: " OS #3 

Unter der Dateinummer 3 wird eine Datenfernübertragungsdatei 
über die RS232-Schnittstelle mit allen Parameter-Voreinstellun¬ 
gen (9600 Baud, gerade Parität, 7 Datenbits, 1 Stopbit, wahlfreie 
Ein-/Ausgabe) geöffnet. 

OPEN ”COMi:4800,N,8, 1" 8S #3 

Es wird eine Datenfernübertragungsdatei unter der Nummer 3 
über die RS232-Schnittstelle für 4800 Baud, keine Paritätsprü¬ 
fung, 8 Datenbits und 1 Stopbit eröffnet. 

• Die Pufferzuordnung erfolgt analog zu den Disk-Dateien. 

• Bei 8 Datenbits muß für die Parität N angegeben werden; bei 
5 Datenbits muß eine Parität definiert sein. N ist dann 
verboten. Bei der Übertragung von rein numerischen Daten 
muß die Wortlänge 8 sein. 

• Aufruf der OPEN “COM.. -Anweisung mit fehlerhaften Pa¬ 
rametern führt zu der Fehlermeldung 


Bad f i 1 e name 


(Falscher Dateiname). 

• Weitere Informationen zur Datenfernübertragung sind in 
Kapitel 5 enthalten. 
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OPTION 

Format: 

Bedeutung: 

Beispiel: 

Anmerkungen: 


BASE-Anweisung 


OPTION BASE n 

Es wird der kleinste Indexwert für Feldvariable definiert. 

n Ein ganzzahliger Ausdruck, dessen Wert 0 oder 1 sein muß. 
Voreingestellt ist der Wert 0. 

OPTION BASE 1 

Die Feldindizes für alle dimensionierten Felder im Programm, die 
normalerweise von 0 an gezählt werden, werden nach dieser 
Anweisung von 1 an gezählt. 

• Die Anweisung OPTION BASE muß, falls sie verwendet wird, 
vor jeder DIM-oder jeder feldbezogenen Anweisung stehen. 
Andernfalls wird der Fehler 


Duplicatedefinition 


(doppelte Definition) angezeigt. 

• Wird für n ein anderer Wert als 0 oder 1 angegeben, so wird 
der Fehler 


Syntax error 


(Syntax-Fehler) angezeigt. 
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PAINT-Anweisung 


Format: PAINT [STEP](x,y) [, Farbe,[Rand\] 

Bedeutung: Malt eine geschlossene Fläche in einer wählbaren Farbe aus. 

x,y Die absoluten oder relativen (mit STEP) Bildschirmkoordina¬ 
ten eines beliebigen Bildpunktes innerhalb des auszumalenden, 
umrandeten Bereiches. 

Farbe Eine Farbnummer zwischen 0 und 3 entsprechend der 
mit einer PALETTE-Anweisung (s. dort) gesetzten Farbkennung. 
In dieser Farbe wird der Bereich ausgemalt. Voreingestellt ist die 
Vordergrundfarbe, die mit der COLOR-Anweisung (s. dort) 
gewählt wurde. 

Rand Eine Farbnummer zwischen 0 und 3 entsprechend der mit 
einer PALETTE-Anweisung (s. dort) gesetzten Farbkennung. 
Dieser Wert spezifiziert die Randfarbe des ausgemalten Berei¬ 
ches. Wird dieser Parameter weggelassen, so wird als Randfarbe 
dieselbe Farbe verwendet, in der auch der Bereich ausgemalt 
wird. 

Beispiel: Radius=5e:x=ze0:y=ie0 

Farbe=3 

CIRCLE (xi^)iRadiusiFarbe 
PftlHT Cx,yFarbe 

Es wird ein orangefarbener (falls die Farbkennung nicht mit der 
PALETTE-Anweisung verändert wurde) Kreis gezeichnet und 
ausgemalt. 

Anmerkungen: • Das Fenster, in dem sich der auszumalende Bereich befin¬ 
det, muß mit einer WINDOW-Anweisung (s. dort), bei der der 
Typ mit einem Wert zwischen 16 und 31 spezifiziert wurde, 
deklariert werden. 


• Siehe auch PATTERN-, AREA- und AREAFILL-Anweisun- 
gen. 
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PALETTE-Anweisung 


Format: PALETTE Farbe,Rot,Grün,Blau 


Bedeutung: Definiert für eine Farbkennung, die von anderen grafischen 

Amiga Basic-Anweisungen verwendet wird, einen Farbton. 

Farbe Ein numerischer Ausdruck, dessen ganzzahliger Wert 
zwischen 0 und 31 liegen muß, und der die Farbkennung für eine 
Farbe, die von den Anweisungen CIRCLE, COLOR, LINE, PAINT, 
PRESET, und PSET benutzt wird, definiert. Der Parameter Tiefe 
bei der SCREEN-Anweisung (s. dort) legt fest, welcher maxima¬ 
le Wert für Farbe angegeben werden kann. Voreingestellt ist hier 
der Wert 3, da das Amiga System ebenfalls voreinstellungsmäßig 
mit 4 Farben arbeitet, nämlich mit 

0 blau 

1 weiß 

2 schwarz 

3 orange 

Jeder andere Farbton, der mit der PALETTE-Anweisung einer 
dieser 4 Kennungen zugewiesen wird, überschreibt den vorein¬ 
gestellten Farbton. In den oben genannten Amiga Basic-Anwei¬ 
sungen kann auf diese vier Farben Bezug genommen werden. 
Mit Hilfe des Voreinstellerprogramms Preferences des Arbeits¬ 
tisches können diese Farben ebenfalls geändert werden. 

Rot,Grün,Blau Numerische Ausdrücke, deren Werte zwischen 
0.00 und 1.00 liegen müssen, und die den prozentualen Anteil der 
Grundfarben rot, grün und blau an der mit Farbe spezifizierten 
Systemfarbe definieren. Als Anhalt kann folgende Tabelle die¬ 
nen, in der für eine Reihe von Farben die Rot-, Grün- und 
Blau-Bestandteile zusammengestellt sind: 
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Beispiel: 


Farbe 

rot 

grün 

blau 

blaugrün 

0.00 

0.93 

0.87 

schwarz 

0.00 

0.00 

0.00 

dunkelblau 

0.40 

0.60 

1.00 

himmelblau 

0.47 

0.87 

1.00 

braun 

0.80 

0.60 

0.53 

grau 

0.73 

0.73 

0.73 

grün 

0.33 

0.87 

0.00 

hellgrün 

0.73 

1.00 

0.00 

orange 

1.00 

0.73 

0.00 

purpur 

0.80 

0.00 

0.93 

kirschrot 

1.00 

0.60 

0.67 

feuerwehrrot 

0.93 

0.20 

0.00 

oker 

1.00 

0.87 

0.73 

violett 

1.00 

0.13 

0.93 

weiß 

1.00 

1.00 

1.00 

gelb 

1.00 

1.00 

0.13 


Farbe: 

PALETTE 1,RND,RND,RND 
PALETTE 2, RND, RND, RND 
COLOR 1,2 

FOR i=l TO 1000 : NEXT 
GOTO Farbe 


ln einer Endlosschleife werden für Vorder- und Hintergrund 
zufällige Farben erzeugt und festgelegt. 
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PATTER N-Anweisung 


Format: PATTERN [Lmuster\ [, Fmuster\ 


Bedeutung: Definiert das Muster, mit dem Linien und/oder Flächen gezeich¬ 

net bzw. ausgemalt werden. 

Lmuster Ein numerischer Ausdruck, dessen ganzzahliger Wert 
das Äquivalent einer 16-Bit-Maske darstellt und der das Muster 
festlegt, in dem Linien gezeichnet werden (z.B. mit der CIRCLE- 
oder der LINE-Anweisung). Jedes gesetzte Bit (1) in dieser 
Maske bedeutet, daß bei einer Linie ein Bildpunkt in der aktuellen 
Vordergrundfarbe gezeichnet wird. Jedes gelöschte Bit (0) be¬ 
deutet, daß dieser Punkt in der Hintergrundfarbe gezeichnet 
wird, also nicht sichtbar ist. Voreingestellt ist hier der Wert 65535 
oder &HFFFF. Linien werden also durchgezogen dargestellt. 

Fmuster Ein Ganzzahlfeld, das das Muster enthält. Der Wert 
jedes Elementes stellt wieder das Äquivalent einer 16-Bit-Mas- 
ke dar, in der 1 einen gezeichneten und 0 einen gelöschten 
Bildpunkt darstellt. Die Anzahl der Elemente in diesem Feld 
bestimmt die Höhe des Musters und muß eine Potenz von zwei 
sein, also 1, 2, 4 ,8, 16 usw. 

Beispiel: DiMFeidxo) 

FeldXC1)=»HSS55 
FeldXC D-aHfiftfifl 
FeldXC2)=SH5555 
Feidx(3)^«Hnnnn 
PATTERN «HFFFF, Feld% 

Bei diesem Beispiel wird für Linien das Muster für durchgezoge¬ 
ne Striche und für Flächen ein Punktmuster definiert, das 4 
Bildpunkte hoch ist. 

Anmerkungen: • Im Abschnitt “Grafische Unterstützung“ des AmigaROM- 
Handbuches ist die Definition von Mustern ausführlich be¬ 
schrieben. 


• Siehe auch AREAFILL-Anweisung. 
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PEEK- 

Format: 

Bedeutung: 


Beispiel: 
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Funktion 


v= PEEK (Adresse) 

Es wird der binäre Inhalt einer spezifizierten Speicherzelle als 
Dezimaläquivalent im Bereich zwischen 0 und 255 übergeben. 

Adresse Ein ganzzahliger Ausdruck, dessen Wert im Bereich 
zwischen 0 und 16777215 liegen muß und der die Adresse der 
auszulesenden Speicherzelle spezifiziert. 

FOH i= 1024 TO 2848 

1F PEEKC i )<>B THEN PRINT PEEK( i ) 

NEXT 

Die Dezimaläquivalente der Speicherinhalte im Adressbereich 
zwischen 1024 und 2048 werden angezeigt, sofern sie von Null 
verschiedenen sind. 


Anmerkungen: Siehe auch PEEKL- und PEEKW-Funktionen sowie POKE-An- 
weisung. 
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PEEKL-Funktion 


Format: v= PEEKL(Atfresse) 

Bedeutung: Es wird der binäre Inhalt einer spezifizierten Speicherzelle als 

Dezimaläquivalent im Bereich zwischen -2147483648 und 
2147483647 als lange Ganzzahl übergeben. 

Adresse Ein ganzzahliger Ausdruck, dessen Wert im Bereich 
zwischen 0 und 16777212 liegen muß und der die Adresse der 
auszulesenden Speicherzelle spezifiziert. Adresse muß eine 
gerade Zahl sein, andernfalls wird die Fehlermeldung 

Illegal function call 

(Unerlaubter Funktionsaufruf) angezeigt. 

Anmerkungen: • Da das Ergebnis als lange Ganzzahl interpretiert wird, kön¬ 
nen auch negative Werte übergeben werden. In diesen Fällen 
ist das oberste Bit gesetzt. 
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PEEKW 

Format: 

Bedeutung: 


Anmerkungen: 


Befehle, Anweisungen und Funktionen 


Funktion 


v= PEEKW(Adresse) 

Es wird der binäre Inhalt einer spezifizierten Speicherzelle als 
Dezimaläquivalent im Bereich zwischen -32768 und 32767 als 
ganze Zahl übergeben. 

Adresse Ein ganzzahliger Ausdruck, dessen Wert im Bereich 
zwischen 0 und 16777214 liegen muß und der die Adresse der 
auszulesenden Speicherzeile spezifiziert. Adresse muß eine 
gerade Zahl sein, andernfalls wird die Fehlermeldung 


1 1 lega1 function call 


(Unerlaubter Funktionsaufruf) angezeigt. 

• Da das Ergebnis als ganze Zahl interpretiert wird, können 
auch negative Werte übergeben werden. In diesen Fällen ist 
das oberste Bit gesetzt. 
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POINT-Funktion 


Format: v= POINT(x,y) 

Bedeutung: Liefert die Farbkennung des Bildpunktes bei den Koordinaten x,y 

im aktuellen Ausgabefenster. Der übergebene Wert entspricht 
der Farbkennung in der PALETTE-Anweisung (s. dort). 

x,y Gültige Koordinaten im aktuellen Ausgabefenster. 

Anmerkungen: • Die Koordinaten (0,0) bezeichnen die linke obere Ecke des 
aktuellen Ausgabefensters. 

• Liegen die Koordinaten ausßerhalb des gültigen Bereiches 
des aktuellen Ausgabefensters, so liefert POINT den 
Wert -1. 
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POKE-Anweisung 


Format: PO KE Adresse,m 

Bedeutung: Es wird der Wert m als 8-Bit-Binärwert in eine spezifizierte 

Speicherzelle geschrieben. 

Adresse Ein ganzzahliger Ausdruck, dessen Wert im Bereich 
zwischen 0 und 16777215 liegen muß und die Adresse der zu 
beschreibenden Speicherzelle darstellt. 

m Ein ganzzahliger Ausdruck, dessen Wert zwisc hen 0 und 255 
liegen muß und der das Äquvalent der zu speichernden Informa¬ 
tion darstellt. 

Beispiel: for i=BTosii 

POKE 650000+ i , 65 
NEXT 

Ab Adresse 650000 werden 512 Bytes mit dem Wert 65 beschrie¬ 
ben. 

Anmerkungen: • Da Amiga Basic keine Adreßprüfung durchführt, muß darauf 
geachtet werden, daß das System nicht durch unerlaubtes 
Überspeichern von Arbeitsspeicherzellen (Stapelspeicher, 
Variablenbereich usw.) lahmgelegt wird. In einem solchen 
Fall muß der Amiga durch gleichzeitiges Drücken der Taste 
CTRL sowie der beiden Amiga-Tasten rückgesetzt, also neu 
gestartet werden. Ggf. speicherresidente Programme wer¬ 
den dadurch gelöscht. 


• Siehe auch PÖKEL- und POKEW-Anweisungen sowie 
PEEK- und VARPTR-Funktionen. 
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POKEL-Anweisung 


Format: PÖKEL Adresse,m 

Bedeutung: Es wird der Wert m als 32-Bit-Binärwert in eine spezifizierte 

Speicherzelle geschrieben. 

Adresse Ein ganzzahliger Ausdruck, dessen Wert im Bereich 
zwischen 0 und 16777212 liegen muß und die Adresse der zu 
beschreibenden Speicherzelle darstellt. Adresse muß eine gera¬ 
de Zahl sein, andernfalls wird die Fehlermeldung 

I1lega1 function call 

(unerlaubter Funktionsaufruf) angezeigt. 

m Ein ganzzahliger Ausdruck, dessen Wert zwischen 
-2147483648 und 2147483647 liegen muß und der das Äquvalent 
der zu speichernden Information darstellt. 

Anmerkungen: • Da Amiga Basic keine Adreßprüfung durchführt, muß darauf 
geachtet werden, daß das System nicht durch unerlaubtes 
Überspeichern von Arbeitsspeicherzellen (Stapelspeicher, 
Variablenbereich usw.) lahmgelegt wird. In einem solchen 
Fall muß der Amiga durch gleichzeitiges Drücken der Taste 
CTRL sowie der beiden Amiga-Tasten rückgesetzt, also neu 
gestartet werden. Ggf. speicherresidente Programme wer¬ 
den dadurch gelöscht. 
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POKEW-Anweisung 


Format: POKEW Adresse,m 

Bedeutung: Es wird der Wert m als 16-Bit-Binärwert in eine spezifizierte 

Speicherzelle geschrieben. 

Adresse Ein ganzzahliger Ausdruck, dessen Wert im Bereich 
zwischen 0 und 16777214 liegen muß und die Adresse der zu 
beschreibenden Speicherzelle darstellt. Adresse muß eine gera¬ 
de Zahl sein, andernfalls wird die Fehlermeldung 


1 1 lega1 function call 


(unerlaubter Funktionsaufruf) angezeigt. 

m Ein ganzzahliger Ausdruck, dessen Wert zwischen -32768 
und 32767 liegen muß und der das Äquvalent der zu speichern¬ 
den Information darstellt. 

Anmerkungen: • Da Amiga Basic keine Adreßprüfung durchführt, muß darauf 
geachtet werden, daß das System nicht durch unerlaubtes 
Überspeichern von Arbeitsspeicherzellen (Stapelspeicher, 
Variablenbereich usw.) lahmgelegt wird. In einem solchen 
Fall muß der Amiga durch gleichzeitiges Drücken der Taste 
CTRL sowie der beiden Amiga-Tasten rückgesetzt, also neu 
gestartet werden. Ggf. speicherresidente Programme wer¬ 
den dadurch gelöscht. 
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POS-Funktion 


Format: y=POS(/j) 

Bedeutung: Liefert die ungefähre Spaltenposition des Textcursors in der 

aktuellen Zeile des aktuellen Ausgabefensters. 


Beispiel: y=csblin * merkt sich vert ikale Pos it ion 

X=POS<0) 'merkt sich horizontale Position 
LOCfiTE 20, 1 

PRINT "Dies ist Zeile 20 ( Schirm—Ende )" 

LOCATEY.X 

PRINT"Die s war die ursprüngl i che Cursor-Pos i t ion'’ 


Bei diesem Beispiel wird die alte Cursor-Position gespeichert, 
dann am unteren Schirmende eine Meldung angezeigt und 
schließlich eine weitere Meldung bei der ursprünglichen Cur¬ 
sor-Position angezeigt. 

Anmerkungen: • Zur Bestimmung der exakten Spaltennummer benutzt Amiga 
Basic die Höhe und Breite der Ziffer Null (0) des für das 
aktuelle Ausgabefenster gewählten Zeichensatzes. 


• Der übergebene Wert ist immer größer oder gleich 1. 
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PRESET 


Formate: 


Bedeutung: 


Beispiel: 


Anmerkungen: 


und PSET-Anweisungen 


PRESET [STEP] [x,y)[,Farbe] 

PSET [STEP] (x,y)[, Farbe] 

Es wird an einer definierten Bildschirmposition ein Punkt ge¬ 
zeichnet. 

x,y Die absoluten oder relativen (mit STEP) Koordinaten des zu 
zeichnenden Punktes. 

Farbe Eine Farbnummer zwischen 0 und 3 entsprechend der 
mit der PALETTE-Anweisung (s. dort) gesetzten Farbkennung. 
Voreingestellt ist die Vordergrundfarbe, die mit der COLOR-An- 
weisung (s. dort) eingestellt wurde. 

Der Unterschied zwischen PRESET und PSET ist der, daß, falls 
für PRESET kein Farb-Parameter angegeben ist, die Hinter¬ 
grundfarbe ausgewählt wird. 

FOR 1=0 TO 100 
PSETC1,1) 

NEXT 

FOR 1 = 100 TO 0 STEP -1 
PRESETC1,I) 

HEXT 

Zunächst wird eine Bildschirmdiagonale in der voreingestellten 
Vordergrundfarbe gezeichnet, die daraufhin wieder gelöscht 
wird, indem sie punktweise auf die Hintergrundfarbe gesetzt 
wird. 

• Werden relative Koordinaten mit STEP angegeben, so ergibt 
sich die endgültige Koordinate aus der Addition der angege¬ 
benen x- und y-Werte zu der aktuellen Position des grafi¬ 
schen Cursors. 

• Koordinatenangaben außerhalb des definierten Bildschirm¬ 
bereiches werden ignoriert. 
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• Ungültige Farbcode-Angaben haben die Fehlermeldung 

I llflgal Function call 

(unerlaubter Funktionsaufruf) zur Folge. 
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PRINT-Anweisung 


Formate: PRINT [Liste von Ausdr\ 

oder 

7[Liste von Ausdr\ 

Bedeutung: Die Werte der Liste von Ausdrücken werden im aktuellen Ausga¬ 

befenster angezeigt. 

Liste von Ausdr Eine beliebige Liste von numerischen und/ 
oder Zeichenkettenausdrücken, deren Werte angezeigt werden 
sollen. Die einzelnen Ausdrücke müssen durch Komma (,), 
Semikolon (;), Sonderzeichen wie # $ & % “ oder Leerstellen 
voneinander getrennt sein. Die Liste muß zusammen mit dem 
Schlüsselwort PRINT oder der Abkürzung ? in einer Programm¬ 
zeile stehen. Jede Zeichenkettenkonstante muß in Anführungs¬ 
zeichen (“) eingeschlossen sein. Wird keine Liste von Ausdrük- 
ken angegeben, so wird eine Leerzeile auf dem Bildschirm 
erzeugt. 

Beispiel 1: o=z:b=3 

PRINT fl+B, fi»B, fitB 

ergibt 

5 6 8 

Ok 

Die Werte der drei in der PRINT-Anweisung angegebenen 
Ausdrücke werden jeweils am Anfang einer Druckzone von 15 
Zeichen Länge (Voreinstellung) angezeigt, da die Ausdrücke in 
der Liste durch Komma getrennt sind (s. Anmerkungen). 
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Beispiel 2: Eingabe: 

INPUT "Zwei Zahlen (0<Z<10)"; fi, B 
lFfl<10Rfl>g0RB<l OR B> 10 THEN Eingabe 
PRIHT”Die Summe isVA+B; 

PRINT M und das Produkt"fl*B 

ergibt die Anzeige: 

Zwei Zahlen (0<Z<10) ?S,7.2 

Die Summe ist. 12.2 und das Produkt 36 

Ok 

Das Semikolon bei der ersten PRINT-Anweisung bewirkt, daß 
beide Ergebnisse in einer Zeile angezeigt werden (s. Anmerkun¬ 
gen). 

Beispiel 3: fori = ito4 

X=X+1:Y=Y+XTZ 
?X; Y; 

NEXT 

ergibt die Anzeige 

1 1 2 5 3 14 4 3B 

Die Semikolons in der PRINT-Anweisung (? ist als Abkürzung für 
PRINT erlaubt) bewirken, daß alle Werte hintereinander gedruckt 
werden. Jeder positiven Zahl wird eine Leerstelle vorangestellt, 
und jeder Zahl wird eine Leerstelle angefügt (s. Anmerkungen). 

Anmerkungen: • Die Position für jeden angezeigten Wert innerhalb der Anzei¬ 
gezeile wird durch die Zeichen bestimmt, mit denen die 
einzelnen Ausdrücke in der Liste voneinander getrennt sind. 
Die Bildschirmzeile wird voreinstellungsmäßig in Druckzo¬ 
nen zu je 15 Spalten unterteilt. Die Breite der Druckzonen 
kann mit der WIDTH-Anweisung (s. dort) verändert werden. 
Ein Komma zwischen zwei Ausdrücken bewirkt, daß der 
Wert des dem Komma folgenden Ausdrucks auf dem Bild¬ 
schirm am Anfang der nächsten Druckzone angezeigt wird 
(s. Beispiel 1). Eine oder mehrere Leerstellen oder ein 
Semikolon zwischen zwei Ausdrücken bedeutet, daß der 
Wert des nachfolgenden Ausdrucks unmittelbar hinter dem 
des vorhergehenden angezeigt wird. 
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• Endet die Liste von Ausdrücken mit einem Komma, Semiko¬ 
lon, der Funktion SPC oder TAB (s. dort), so werden die 
nächsten PRINT-Anweisungen von der dadurch definierten 
Spaltenposition an in derselben Zeile ausgeführt (s. Bei¬ 
spiel 2). 

• Endet die Liste von Ausdrücken ohne Komma, Semikolon, 
SPC- oder TAB-Funktion, so wird ein Wagenrücklauf und 
Zeilenvorschub ausgeführt, der Cursor also an den Anfang 
der nächsten Zeile gesetzt. 

• Ist ein anzuzeigender Wert länger als der noch verfügbare 
Platz in der Zeile, so wird der gesamte Wert am Anfang der 
nächsten Zeile angezeigt. 

• Ist der Wert länger als die mit der WIDTH-Anweisung defi¬ 
nierte Bildschirmbreite, so wird der nicht mehr in eine Zeile 
passende Rest am Anfang der folgenden Bildschirmzeile 
angezeigt. 

• Wurde eine Ausgabe in der letzten Zeile des aktuellen 
Ausgabefensters veranlaßt, so führt ein Wagenrücklauf/ 
Zeilenvorschub zum Aufrollen des definierten Bildschirmfen¬ 
sters um eine Zeile. 

• Nach angezeigten numerischen Werten wird immer eine 
Leerstelle angefügt. Ebenso vor positiven numerischen Wer¬ 
ten (s. Beispiel 3); vor negativen wird ein Minuszeichen (-) 
eingefügt. 

• Zahlen einfacher Genauigkeit, die mit sieben oder weniger 
Stellen im Festpunktformat dargestellt werden können, ohne 
an Genauigkeit zu verlieren, werden im Festpunkt- oder 
ganzzahligen Format angezeigt; alle anderen in der Expo- 
nentialdarstellung des Gleitpunktformats: 

print ieT-7 ergibt .eeeaeei 
PRINT leT-e ergibt ie-88 
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PRINT USING-Anweisung 


Format: PRINT USING v$-,Liste von Ausdr[\\ 

Bedeutung: Die Werte der Liste von Ausdrücken werden entsprechend dem 

in der Anweisung angegebenen Format auf dem Bildschirm 
angezeigt. 

v$ Eine Zeichenkettenvariable oder -konstante, die das Druck¬ 
format definiert. 

Liste von Ausdr Eine beliebige Liste von numerischen und/ 
oder Zeichenkettenausdrücken, deren Werte auf dem Bildschirm 
angezeigt werden sollen. Die einzelenen Ausdrücke müssen 
duch Komma (,), Semikolon (;) odereine oder mehrere Leerstel¬ 
len voneinander getrennt sein. Hier führt das Komma nach einem 
Ausdruck jedoch nicht zur Tabulierung auf den Anfang der 
nächsten Druckzone. Die Formatierung der Ausgabe erfolgt 
durch Steuerzeichen, deren Wirkung im folgenden getrennt für 
Zeichenketten- und numerische Druckfelder beschrieben wird. 

Zeichenkettenfelder: 

! Nur das erste Zeichen einer gegebenen Zeichenkette soll 
angezeigt werden. 

\n Leerstellent Es sollen 2 + n Zeichen einer gegebenen Zei¬ 
chenkette angezeigt werden. Ist die Zeichenkette länger als n 
Zeichen, werden die überzähligen Zeichen ignoriert. Ist sie 
kürzer, werden die Zeichen linksbündig angezeigt. Rechts wer¬ 
den Leerstellen angefügt. 

Beispiel 1: fi$="REGEN": b$=”bogen” 

PRINT USING •’!•’; D$ 

PRINT USING 

PRI NT USING \ 1 ”; fl$; B$; ” ! ! " 

ergibt die Anzeige 

RB 

REGENBOGEN 
REGEN BOGEN ! ! 

Ok 
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& Es wird ein Druckfeld variabler Länge definiert, d.h., der 
anzuzeigende Zeichenkettenausdruck wird in seiner vollen Län¬ 
ge ausgegeben. 

Beispiel 2: fi$="REGEN":B$="BOGEN" 

PRINT USING 
PRINT USING B$ 

ergibt die Anzeige 

RBOGEN 

Ok 

Numerische Felder 

# Das Nummernzeichen bezeichnet eine Ziffernposition. Hat 
die anzuzeigende Zahl weniger Ziffern, als dafür Positionen 
definiert sind, wird sie rechtsbündig mit führenden Leerstellen im 
Feld angezeigt. Ein Punkt (.) in der Formatzeichenkette kenn¬ 
zeichnet die Position des Dezimalpunktes. Soll links vom Punkt 
eine Ziffer ausgegeben werden, so wird, falls keine Stelle links 
vom Punkt angezeigt würde, eine Null (0) ausgegeben. Wird für 
eine gebrochene Zahl ein Formatfeld ohne Punkt angegeben, so 
wird die Zahl vor der Anzeige entsprechend gerundet. 

Beispiel 3: print using . 15 

B. 15 
Ok 

PRINT USING ”##. ##"; 12.123 
12.12 
Ok 

PRINT USING ”'###. ##"; 15.1, 1.829, . 321 
15.10 1.83 0.32 
Ok 

+ Ein Plus-Zeichen am Anfang oder Ende der Formatzeichen¬ 
kette bewirkt je nach Wert des Ausdruckes die Ausgabe eines 
Plus- oder Minus-Zeichens vor oder hinter dem Wert. 

- Ein Minus-Zeichen am Ende der Formatzeichenkette bewirkt 
die Ausgabe eines Minuszeichens hinter negativen Werten. 
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Beispiel 4: 


Beispiel 5: 


Beispiel 6: 


Beispiel 7: 


PRINT US ING ” + ##. ##"; -80.5, 2.89, 4 

-80.50 *2.89 -0.40 
Ok 

PRINT USING "##. ##-"; -80.5, 2.89, -. 4 
80.5-2.89 0.40- 
Ok 


** Führende Leerstellen bei einem Wert werden mit Sternen 
aufgefüllt. Dabei stehen die beiden Sterne für Ziffernpositionen. 

PRINT USING ”**#.##"; 10. 46, - . 9, 150.3 
*10.46»—0.90150.30 
Ok 

$$ Vor dem Zahlenwert wird ein Dollarzeichen angezeigt. Beide 
Dollarzeichen stehen für Zeichenpositionen; eines davon für das 
Dollarzeichen selbst. Bei der Exponentialdarstellung können die 
Dollarzeichen nicht verwendet werden. Ebenso bei negativen 
Werten, es sei denn, das Minuszeichen steht hinter der Zahl. 

PRINT USING ”$$###.##";390.85 
$390.85 
Ok 

**$ Die beiden zuletzt beschriebenen Formatsteuerungen wer¬ 
den kombiniert. Führende Leerstellen werden mit Sternen aufge¬ 
füllt und es wird vor dem Wert ein Dollarzeichen ausgegeben. 
Diese Formatsteuerung steht selbst für drei Zeichenpositionen; 
eine davon ist das Dollarzeichen selbst. 

PRINT USING "**$##.#11'’; 1.85 
***$1.85 
Ok 


, Ein Komma unmittelbar links vom Dezimalpunkt in der Format¬ 
kette bewirkt, daß in allen Tausenderpositionen links vom Dezi¬ 
malpunkt ein Komma in den anzuzeigenden Wert eingefügt wird. 
Ein Komma am Ende der Formatkette wird als Komma an dieser 
Position mit ausgegeben. Das Komma definiert selbst eine 
Zeichenposition. Beim Exponentialformat (s. unten) hat die 
Angabe eines Kommas keine Wirkung. 
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Beispiel 8: 


Beispiel 9: 


Beispiel 10: 


Beispiel 11: 


PRINT USING "####, .##”;5876.7 
5,876.70 
Ok 

PRINT USING"####.##,”; 5876.7 
5876.70, 

Ok 


jfft Werden vier Potenzierungssymbole an die Formatzei¬ 
chenkette angefügt, so wird dadurch das Exponentialformat 
(E+ nn oder E-nn) definiert. Es kann jede Dezimalpunktposition 
angegeben werden. Signifikante Ziffern werden linksbündig aus¬ 
gegeben. Ist kein führendes Plus oder nachfolgendes + bzw. - 
angegeben, wird eine Position links vom Dezimalpunkt für das 
Vorzeichen vorgesehen. 

PRINT USING ”##. ##tttt”; 186.27 
1.86E-*02 
Ok 

PRINT USING " . ###tttt-"; -88888 
.889E+0S- 
Ok 

PRINT USING"+. ##tttt"; 154 
+.15E+0.3 
Ok 


Ein Unterstreichungsstrich bewirkt, daß das nächste Zeichen 
der Formatzeichenkette als Zeichen selbst ausgegeben wird. 

PRINT USING "_^##. ##_^"; 13.769 

✓'13.77.'' 

Ok 

Wenn die darzustellende Zahl mehr Stellen enthält, als die dafür 
definierte Formatzeichenkette, so wird die Zahl mit vorangestell¬ 
tem Prozentzeichen (%) ausgegeben. 

PRINT USING ”#».##”; 238.15 
*238.15 
Ok 

Schließlich darf die Formatzeichenkette auch Zeichenkettenkon¬ 
stanten enthalten: 
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Beispiel 12: PRINT USING "Dies ist Beispiel _*##"; 12 

Dies ist Beispiel tt 12 
Ok 

Anmerkungen: • Werden in der Formatzeichenkette mehr als 24 Ziffernposi¬ 
tionen definiert, so wird die Fehlermeldung 

Illegal F unction ca I I 


(unerlaubter Funktionsaufruf) angezeigt 
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PRINT #- und 

PRINT #,USING-Anweisungen 


Format: PRINT #Dateinr, [USING v$i\Liste von Ausdr 

Bedeutung: Es werden Daten in eine sequentielle Disk-Datei oder an eine 

sequentielle Einheit ausgegeben. 

Dateinr Ein ganzzahliger Ausdruck, unter dessen Wert die Datei 
oder Einheit für sequentielle Ausgabe eröffnet wurde. 

v$ Eine Zeichenkettenvariable oder -konstante, die das Ausga¬ 
beformat definiert (s. dazu PRINT USING-Anweisung). 

Liste von Ausdr Eine beliebige Liste von numerischen und/ 
oder Zeichenkettenausdrücken, deren Werte in die Datei oder an 
die Einheit ausgegeben werden sollen. Die einzelnen Ausdrücke 
müssen durch Komma (,) oder (bei numerischen Ausdrücken 
immer) durch Semikolon (;) getrennt werden. Da durch die 
PRINT #-Anweisung die Daten in der Datei nicht komprimiert 
werden, sondern vielmehr so ausgegeben werden, wie sie auch 
auf dem Bildschirm mit PRINT angezeigt werden, wird im folgen¬ 
den an verschiedenen Beispielen gezeigt, wie die einzelnen 
Ausdrücke richtig durch Trennzeichen getrennt werden müssen, 
damit sie später wieder korrekt mit der INPUT ^-Anweisung (s. 
dort) gelesen werden können. 

Beispiel 1: CR$=CHR$<13I:fi=l:B=2.5:C=4:D=28 

PRINT *1, ft; CR$B; CR$C; CR$D 

Die numerischen Variablen A bis D werden mit Wagenrücklauf¬ 
codes getrennt ausgegeben, so daß sie mit INPUT #n,A,B,C,D 
wieder gelesen werden könnten. Zwischen der Variablen CR$ 
und der jeweils folgenden numerischen Variablen braucht kein 
Semikolon angegeben zu werden, da das Dollarzeichen dem 
Interpreter das Ende einer Zeichenkettenvariablen anzeigt. Kom¬ 
mas (,) als Trennzeichen führen bei PRINT # zu einer identi¬ 
schen Formatierung in 15 Stellen (voreingestellt, kann mit der 
WIDTH-Anweisung geändert werden) lange Druckfelder wie bei 
der Bildschirmausgabe mit PRINT (s. dort). 
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Beispiel 2: 


Beispiel 3: 


Beispiel 4: 


Beispiel 5: 


Anmerkungen: 


P$=”SONNENBLUMEN”:B$=”KERN” 

PRINT 1*2, R$; B$ 

Hier würde SONNENBLUMENKERN ausgegeben werden, da 
das Semikolon nach A$ die Ausgabe eines Trennzeichens 
unterdrückt. 


fl$="SONNENBLUMEN” : B$=”KERN" : C$=” , " 

PRINT «2, A$C$ 

In diesem Fall wird SONNENBLUMEN,KERN ausgegeben, was 
wieder in getrennte Zeichenkettenvariablen eingelesen werden 
könnte, da das Komma für INPUT # ein Trennzeichen darstellt. 

ft$="fiUTO,KFZ";:B$=”NUMMER”:C$=CHR$C34) 

PRINT 1*2, C$; B$; C$ 


Zeichenketten, die signifikante führende Leerstellen, Semiko¬ 
lons, Kommas, Wagenrücklauf- und/oder Zeilenvorschubcodes 
enthalten, müssen bei der Ausgabe in Anführungsstriche 
(“=CHR$(34)) eingekleidet werden, damit sie mit INPUT # 
wieder richtig gelesen werden können. 

100 PRINT ttl, USING "_snU. **#”; fl 

Auch bei der Dateiausgabe können numerische Werte mit Hilfe 
der PRINT # USING-Anweisung formatiert ausgegeben wer¬ 
den. 

• Da bei der PRINT #-Anweisung die Ausgabe korrekter 
Trennzeichen vom Anwender genau beachtet werden muß, 
empfiehlt sich die sequentielle Datenausgabe mit der WRITE 
#-Anweisung (s. dort). 


• Weitere Einzelheiten siehe Kapitel 5. 
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PSET-Anweisung 


Siehe bei PRESET-Anweisung. 
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PTAB-Funktion 


Format: PRINT PTAB(n) 

Bedeutung: Die Druckposition wird in der aktuellen Zeile des aktuellen 

Ausgabefensters auf n Bildpunkte vom linken Rand (Bildpunkt 0) 
gesetzt. Befindet sich die aktuelle Druckposition rechts von 
Bildpunkt n, so wird auf Bildpunkt n in derselben Zeile positio¬ 
niert. 


n Ein numerischer Ausdruck, dessen ganzzahliger Wert zwi¬ 
schen 0 und 32767 liegen muß. 

Anmerkungen: • Die PTAB-Funktion entspricht der TAB-Funktion (s. dort). 

Es wird jedoch nicht um Druckspalten, sondern um Bild¬ 
punkte tabuliert. 

• Die PTAB-Funktion darf nur in Verbindung mit der PRINT- 
Anweisung verwendet werden. 

• Steht die PTAB-Funktion am Ende einer Liste von Ausdrük- 
ken, so wird kein Wagenrücklauf/Zeilenvorschub ausge¬ 
führt. 
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PUT-Anweisung für Dateien 


Format: PUT [#]Dateinr[,Satznr\ 

Bedeutung: Der Inhalt des Puffers für wahlfreien Zugriff wird als logisch 

nächster oder als Satz mit angegebener Satznummer in eine 
Datei für wahlfreien Zugriff geschrieben. 


Dateinr Die Nummer, unter der die Datei für wahlfreien Zugriff in 
der OPEN-Anweisung (s. dort) eröffnet wurde. 


Satznr Die Nummer des zu schreibenden logischen Datensat¬ 
zes, die zwischen 1 und 16777215 liegen muß, wenn sie angege¬ 
ben wird. 

Beispiel: Siehe Beispiel bei MKI$-, MKL$-, MKS$- und MKD$-Funktio- 

nen. 

Anmerkungen: • Die Anweisungen PRINT #, PRINT # USING, WRITE #, 
RSET und LSET können dazu benutzt werden, Daten in den 
Puffer zu übertragen, ehe PUT ausgeführt wird. Bei WRITE # 
wird der Puffer nach den Daten bis zur definierten Satzlänge 
mit Leerstellen aufgefüllt. 

• Der Versuch, mehr Daten in den Puffer zu übertragen, als 
dessen in der OPEN-Anweisung definierte Länge zuläßt, 
führt zu der Fehlermeldung 


Field overfIou 


(Feldüberlauf). 

• Das Betriebssystem AmigaDOS legt auf Diskette oder Fest¬ 
platte physikalische Sätze (Sektoren) von 512 Bytes Länge 
an, die fortlaufend die logischen Sätze enthalten, so daß bei 
kürzeren logischen Sätzen mehrere in einen physikalischen 
Satz passen. Deshalb führt eine PUT-Anweisung nicht unbe¬ 
dingt zu einem physikalischen Schreibvorgang. 

• Weitere Hinweise zur Dateiausgabe mit PUT werden im 
Kapitel 5 gegeben. 
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PUT-Anweisung für Grafik 


Format: PUT [STEP] (x,rf,Feldvar [(Inde^,Index.. .,lndex\)][,Modus] 

Bedeutung: Es werden Daten aus einem numerischen Feld als binäre Infor¬ 

mation entnommen und als farbige Punkte im aktuellen Ausga¬ 
befenster dargestellt. 

x,y Die absoluten oder relativen (mit STEP) Koordinaten der 
linken oberen Ecke des aktuellen Bildschirmfensters. 

Feldvar Eine numerische Feldvariable beliebiger Genauigkeit, 
in der die Punktinformation bitweise abgelegt ist (s. dazu GET- 
Anweisung für Grafik). 

Index Die optionale Angabe von Feldelementen über deren 
Index erlaubt den Zugriff auf mehrere in einem mehrdimensiona¬ 
len Feld gespeicherte grafische Objekte. 

Modus Der Modus beschreibt die Art, wie die Daten auf den 
Bildschirm gebracht werden sollen oder wie bereits auf dem 
Bildschirm befindliche Daten manipuliert werden können. Es gibt 
folgende Modi: 

PSET Die Daten aus dem Feld werden direkt auf den Bild¬ 
schirm übertragen. Jeder Punkt hat dieselbe Farbe, mit 
der er mit der GET-Anweisung für Grafik gespeichert 
wurde. 

PRESET Genau wie bei PSET. Das Bild wird nur invertiert. 

AND Es werden nur dann Bildpunkte übertragen, wenn unter 
den zu übertragenden Bildpunkten bereits Bildpunkte 
auf dem Schirm existieren. Das vorhandene Bild wird 
also durch ein logisches UND mit dem zu übertragen¬ 
den Bild verknüpft. 


OR 


Es wird einem vorhandenen Bild das zu übertragende 
Bild überlagert (logisch mit ODER verknüpft). 
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XOR Es werden im existierenden Bild dort die Bildpunkte 
invertiert, wo im zu übertragenden Bild Bildpunkte 
existieren. Dadurch kann ein Objekt über den Bild¬ 
schirm bewegt werden, ohne den Hintergrund zu lö¬ 
schen. XOR ist der voreingestellte Modus. 

Die Bewegung eines Bildes kann folgendermaßen erreicht werden: 

1. Das Bild wird wird mit PUT im Modus XOR auf den Bildschirm 
gebracht. 

2. Eine veränderte Bildschirmposition wird errechnet. 

3. Das Bild wird erneut mit PUT im Modus XOR an die alte Stelle 
gebracht, wodurch es dort gelöscht wird. 

4. Schritt 1 wird mit der neuen Bildposition wiederholt. 

Der Bildschirmhintergrund bleibt dabei unverändert. Bewegun¬ 
gen mit verändertem Hintergrund können auch mit dem Modus 

PSET erreicht werden. Hier sind allerdings zwei Felder für die 

Daten vor und nach der Veränderung erforderlich. 

Anmerkungen: • Paßt das im Feld gespeicherte Bild nicht auf den Schirm, wird 
die Fehlermeldung 


Illegal Function call 


(unerlaubter Funktionsaufruf) angezeigt. 
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RANDOMIZE-Anweisung 


Formate: RANDOMIZE [/>] 

RANDOMIZE TIMER 

Bedeutung: Der Zufallszahlengenerator wird mit einem neuen Anfangswert 

gestartet. 

n Ein beliebiger numerischer Ausdruck, dessen Wert den 
Ausgangswert für die Zufallszahlenerzeugung festlegt. Wird n 
weggelassen, fordert Amiga Basic mit der Anzeige 

Random number seed (—32768 to 32767)? 

die Eingabe eines Anfangswertes, ehe der Zufallszahlengenera¬ 
tor gestartet wird. 

Wird die Anweisung RANDOMIZE TIMER ausgeführt, so wird für 
jeden Programmlauf, der mit RUN gestartet wird, eine neue 
Zufallszahlenreihe erzeugt, ohne daß ein Anfangswert angefor¬ 
dert wird. Der Anfangswert wird vielmehr intern mit der TIMER- 
Funktion erzeugt. 

Beispiel: RfmDomzE 

FOR 1 = 1 TO 3 
PRIMT RND 
NEXT 

ergibt nach der Angabe von z.B. 3 die Anzeige 

Random number seed( —32768 to 32767)? 3 
. 2633472681045532 
. 8897488713264465 
. 9760591983795166 
Ok 

Anmerkungen: • Für jeden Programmdurchlauf werden dieselben Zufallszah¬ 
len ausgegeben (s.a. RND-Funktion), wenn kein neuer An¬ 
fangswert definiert wird. 
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READ-An Weisung 


Format: READ Var[,Var\... 

Bedeutung: Es werden Daten aus DATA-Anweisungszeilen gelesen und 

Variablen zugewiesen (s.a. DATA-Anweisung). 

Var Numerische, Zeichenketten-Variable oder Feldelemente, 
denen entsprechende Werte aus DATA-Anweisungen zugeord¬ 
net werden. 


Beispiel: Siehe Beispiel bei DATA-Anweisung. 

Anmerkungen: • Die READ-Anweisung kann nur aus DATA-Zeilen Daten 
lesen, die ohne Veränderung den angegebenen Variablen 
zugewiesen werden. Deshalb müssen die gelesenen Werte 
im Typ mit den bezogenen Variablen übereinstimmen. An¬ 
dernfalls wird die Fehlermeldung 

Type mismatch 

(keine Typübereinstimmung) 
angezeigt. 

• Mit der READ-Anweisung werden die in einer oder mehreren 
DATA-Zeilen gespeicherten Daten in Reihenfolge gelesen. 

• Wurden bereits alle Daten gelesen, so erzeugt eine weitere 
READ-Anweisung die Fehlermeldung 

Out of DftTfi 

(zu wenig Daten), es sei denn, der Lesezeiger wurde vorher 
mit der RESTORE-Anweisung (s. dort) zurückgesetzt. 
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REM-Anweisung 


Format: REM Kommentartext 

Bedeutung: Es können einzelne Kommentare oder komplette Kommentarzei¬ 

len in ein Programm eingefügt werden. 

Kommentartext Eine beliebige Zeichenfolge. 

Beispiel: REM Rddition der Zahlen Ibis 10 

SUf1ME= 0 : REM Summe rücksetzen 
FOR 1 = 1 TO 9 

summe=summe+i 

NEXT 

PRINT SUMME 'Ergebnis Anzeigen 

Anmerkungen: • REM-Anweisungen werden nicht ausgeführt, wohl aber geli¬ 
stet. Sie verlängern aber die Programmlaufzeit. 

• REM-Anweisungen müssen als letzte Anweisung in einer 
Programmzeile stehen, wenn davor ausführbare Amiga Ba- 
sic-Anweisungen in derselben Zeile stehen. 

• Wird mit GOTO oder GOSUB zu einer Zeile, in der nur eine 
REM-Anweisung steht, verzweigt, so wird das Programm 
mit der nächsten auf die REM-Anweisung folgenden Zeile, 
die keine REM-Anweisung mehr enthält, fortgesetzt. 

• Kommentare können auch mit vorangestelltem Apostroph (’) 
in BASIC-Programmzeilen eingefügt werden (s. Beispiel). 
Allerdings müssen sie auch hier am Ende der Zeile stehen 
und dürfen nicht in DATA-Zeilen verwendet werden! 

Den Apostroph erhalten Sie auf einer deutschen Tastatur 
durch die Tastenkombination ALT-Shift-Ä. 

• Kommt in einem Kommentartext ein kleines “ü“ vor, ist er mit 
einem Gänsefüßchen einzuleiten. 



9-206 


Befehle, Anweisungen und Funktionen 


RESTORE-Anweisung 


Format: RESTORE [Marke] 

Bedeutung: Der Lesezeiger der READ-Anweisung (s. dort) wird auf das erste 

DATA-Element der ersten oder einer bestimmten DATA-Zeile im 
Programm gestellt, um DATA-Elemente wiederholt zu lesen. 

Marke Eine gültige Programmzeilennummer oder alphanumeri¬ 
sche Sprungmarke, bei der eine DATA-Anweisung stehen muß. 


Beispiel: Daten: 

DATA 1, Z, 3,4, 5, 6 
READ U, U,W 
RESTORE Daten 
READ X, V, Z 
PR1MT U; U;W; X; Y; Z 


ergibt die Anzeige 

12 3 12 3 

Ok 

Durch die Anweisung RESTORE Daten wird, nachdem die ersten 
drei DATA-Elemente gelesen wurden, der Lesezeiger wieder auf 
den Anfang der DATA-Zeile bei der Marke Daten: gestellt. Die 
nachfolgende READ-Anweisung liest wieder die ersten drei 
DATA-Elemente. 
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RESUME 


Formate: 


Bedeutung: 


Beispiel: 


Anmerkungen: 


Anweisung 


RESUME [0] 

RESUME NEXT 
RESUME Marke 

Das Programm wird nach Ausführen einer Fehlerbearbeitungs¬ 
routine (s. ON ERROR-Anweisung) an einer definierten Stelle 
fortgesetzt, 

RESUME oder RESUME 0 Das unterbrochene Programm wird 
mit der Anweisung, die den Fehler verursacht hat, fortgesetzt. 

RESUME NEXT Das unterbrochene Programm wird mit der 
Anweisung, die der fehlerverursachenden Anweisung folgt, fort¬ 
gesetzt. 

RESUME Marke Das unterbrochene Programm wird mit der 
durch Marke definierten Zeile fortgesetzt. 

ON ERROR GOTO Fehler 


Feh lex»: 

IF ERR = £>1 THEN RESUME DiskUechsel 

Falls die Fehlerbehandlungsroutine bei Zeile Fehler: den Fehler 
“Disk full“ (Disk voll) diagnostiziert, soll das Programm mit der 
Zeile DiskWechsel: fortgesetzt werden. 

• Wenn die RESUME-Anweisung außerhalb einer Fehlerbear¬ 
beitungsroutine steht, wird die Fehlermeldung 


RESUME without error 


(RESUME ohne Fehler) angezeigt. 



9-208 Befehle, Anweisungen und Funktionen 

RETURN-Anweisung 


Format: RETURN [Marke] 

Bedeutung: Das Programm verzweigt nach der Ausführung einer Subroutine 

entweder zu der Anweisung zurück, die dem Subroutinenaufruf 
folgt, oder zu einer angegebenen Zeile. 

Marke Eine gültige Programmzeilennummer oder alphanumeri¬ 
sche Sprungmarke, zu der nach Abarbeitung einer nichtlokalen 
Ereignisunterbrechungsroutine (s.a. ON BREAK-, ON COLLISI¬ 
ON-, ON MENU-, ON MOUSE-, ON TIMER-Anweisungen) ver¬ 
zweigt werden soll, damit nicht nach der aufrufenden ON Ereig¬ 
nis GOSUB-Anweisung weitergearbeitet zu werden braucht. 

Anmerkungen: • Bei der Angabe einer Zeilennummer in der RETURN-Anwei¬ 
sung ist mit Vorsicht vorzugehen, da alle zur Zeit der 
Unterbrechung aktivierten GOSUB-, WHILE- und FOR-An- 
weisungen auch hinterher noch aktiv bleiben. 
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RIGHT$ 

Format: 

Bedeutung: 


Beispiel: 


Anmerkungen: 


Funktion 


v$= RIGHT$(xS,n) 

Der rechte Teil der spezifizierten Zeichenkette wird in einer 
wählbaren Länge übergeben. 

x$ Beliebiger Zeichenkettenausdruck. 

n Beliebiger numerischer Ausdruck, dessen ganzzahliger Wert 
zwischen 0 und 32767 liegen muß. 

C$ = " Commoiinrf! Buernmasch i n t: n " 

PRINT RIGHT$(C$, 14) 

ergibt die Anzeige 


Bueromaschinen 

Ok 

Die letzten 14 Zeichen der Zeichenkette C$ werden im aktuellen 
Ausgabefenster angezeigt. 

• Ist n größer als die Länge von x$, so wird x$ vollständig 
übergeben. 

• Bei n =0 wird eine Leer-Zeichenkette (Länge 0) übergeben. 

• Weitere teilkettenbildende Funktionen sind MID$ und LEFT$ 
(s. dort). 
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RND-Funktion 


Format: v=RUD[(x)} 

Bedeutung: Es wird eine Zufallszahl im Bereich zwischen 0 und 1 übergeben. 

x Ein beliebiger numerischer Ausdruck, dessen Wert die über¬ 
gebene Zufallszahl folgendermaßen bestimmt. 


x Wirkung 

fehlt Die nächste Zufallszahl aus einer Folge, die der 

Interpreter durch einen numerischen Algorithmus 
ermittelt, wird übergeben. 

positiv Wie oben. 

negativ Der Anfangswert für den Zufallszahlengenerator 

wird abhängig von x neu gesetzt, wodurch für glei¬ 
che negative x-Werte immer dieselbe Folge erzeugt 
wird. 

Null Die letzte erzeugte Zufallszahl wird noch einmal 

übergeben. 


Beispiel: for i = ito 3:<*=rnd( d 

PRINT a; ' X>0 

NEXT:PRINT 

x=RND(—6) 'X<0 

FOR i= 1 TO 3: a=RND( i) 

PRINT a; ' X>0 

NEXT:PRINT 

RPNDOMI ZE 520 * neuer flnf angs Wert 
x= RNDC —6) ' X<0 

FOR i = lTO 3 : a=RND( i ) 

PRINT a; 

NEXT:PRINT 
PRINT RND(0) 


'wie X>0 
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ergibt die Anzeige 

.1213501.651861.8688611 
6.296182E-02.7981562 .9540843 

6.296182E—02.7981562 .9540843 
.9540842771530151 
Ok 

Anmerkungen: • Wird der Anfangswert für den Zufallszahlengenerator nicht 
neu gesetzt (s. RANDOMIZE-Anweisung), so wird bei jedem 
Programmdurchlauf dieselbe Zufallszahlenfolge erzeugt. 

• Das Neusetzen des Anfangswertes kann neben der RANDO¬ 
MIZE-Anweisung auch durch die RND-Funktion mit negati¬ 
vem Argument erfolgen. Gleiche negative Argumente führen 
dann zu gleichen Zufallszahlenfolgen, die nicht durch die 
RANDOMIZE-Anweisung beeinflußbar sind. 

• Ganze Zufallszahlen im Bereich 0 bis n können mit der 
Formel 

INT(RND*(n + 1)) 


erzeugt werden. 
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RSET-Anweisung 


Format: RSET Zeichenkettenvariable = x$ 

Bedeutung: Es werden in Vorbereitung für die PUT-Anweisung für Dateien 

Daten rechtsbündig in einen Dateipuffer für wahlfreien Zugriff 
übertragen. 

Zeichenkettenvariable Der Name einer Zeichenkettenvariab¬ 
len, die in einer FIELD-Anweisung als Datenfeld definiert wurde. 

x$ Beliebiger Zeichenkettenausdruck, dessen Wert die Daten 
repräsentiert, die in dem durch die Zeichenkettenvariable be¬ 
stimmten Feld rechtsbündig abgelegt werden sollen. 

Beispiel: rset Y$=nKs$(Num 

Der numerische Wert NUM wird bei der rechtsbündigen Spei¬ 
cherung im Datenfeld Y$ als Zeichenkette interpretiert (s. An¬ 
merkungen und MKS$-Funktion). 

Anmerkungen: • Ist die Länge der zu speichernden Daten kleiner als das 
definierte Feld, so wird das Feld links mit Leerstellen aufge¬ 
füllt. Ist sie größer, wird rechts abgeschnitten. 

• Numerische Werte müssen vor der Speicherung mit RSET 
oder LSET (s. dort) durch die Funktionen MKI$ (s. dort) als 
Zeichenketten interpretiert und behandelt werden. 

• In LSET- und RSET-Anweisungen können auch andere als 
durch FIELD-Anweisungen definierte Datenfelder verwen¬ 
det werden (z.B. für Druckformaterstellung). 

• Weitere Informationen zum Datenaustausch mit Dateien für 
wahlfreien Zugriff sind im Kapitel 5 zu finden. 
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RUN-Befehl 


Formate: RUN [Mark e] 

RUN Dateiangabe[,B\ 

Bedeutung: Ein Amiga Basic-Programm, das entweder im Hauptspeicher 

resident ist oder von Disk geladen wird, wird gestartet. 

Marke Eine gültige Programmzeilennummer oder alphanumeri¬ 
sche Sprungmarke, bei der das Programm gestartet werden soll. 

Dateiangabe Ein Zeichenkettenausdruck für eine Dateispezifi¬ 
kation, wie in Kapitel 5.2 beschrieben. 

R Der Parameter R verhindert, wenn er angegeben ist, daß vor 
dem Programmstart ggf. geöffnete Dateien geschlossen wer¬ 
den. 

Beispiel 1: fori = itoz 

PR I MT ITZ; 

NEXT 

Hallo: 

PRIMT "HOLLO ! ” 

Ergibt bei der Eingabe von RUN 

1 4 HOLLO ! 

Ok 

und bei RUN Hallo 

HOLLO ! 

Ok 

Beispiel 2: run "progi", r 

Das Programm PROGI wird von der Diskette im aktuellen 
Laufwerk geladen und gestartet. Alle vorher ggf. geöffneten 
Dateien bleiben offen. 
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Anmerkungen: • Der Befehl RUN im Direktmodus im Ausgabefenster einge¬ 
geben, hat dieselbe Wirkung wie das Wählen von Start aus 
dem Run-Menü. 

• Wird keine Marke angegeben, wird das Programm mit der 
ersten ausführbaren Zeile gestartet. 

• Wird im RUN-Befehl eine Datei spezifiziert, so wird vor dem 
Laden, falls ein anderes Programm im Hauptspeicher ist, 
dem Anwender durch ein Kommunikationsfenster die Mög¬ 
lichkeit gegeben, dieses Programm zu speichern, da der 
Programmspeicher vor dem Laden gelöscht wird. Der Datei¬ 
name muß derselbe sein, unter dem das zu ladende Pro¬ 
gramm ursprünglich gespeichert wurde. Außerdem werden 
alle ggf. geöffneten Dateien geschlossen, es sei denn, der 
Parameter R wurde angegeben, (s.a. Kapitel 5). 
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SADD-Funktion 


Format: v— S AD D (Zeichenkettenausdruck) 


Bedeutung: Liefert die aktuelle Speicheradresse des ersten Zeichens eines 

angegebenen Zeichenkettenausdruckes. 

Zeichenkettenausdruck Ein beliebiger Zeichenkettenaus¬ 
druck, dessen Anfangsadresse übergeben werden soll. 

Beispiel: CALL f)nzei 3 e(SADD("Uieviel li «ch4(0)) 


Anmerkungen: • Die übergebene Adresse ist nur solange gültig, wie keine 
neue Zeichenkettenzuweisung im Programm erfolgt, da Ami- 
ga Basic seinen Zeichenkettenspeicher dynamisch ver¬ 
waltet. 

• Die Verwendung der Funktion VARPTR (s. dort) sollte bei 
Zeichenkettenvariablen vermieden werden, da sich das For¬ 
mat der Zeichenkettendeskriptoren, deren Adresse durch 
VARPTR (Zeichenkette) übergeben wird, zukünftig ändern 
kann. 
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SAVE- 

Format: 

Bedeutung: 


Beispiel 1: 

Beispiel 2: 

Beispiel 3: 


Befehl 


SAVE [Dateiangabe][,Ä\[,P][,B ] 

Ein im Hauptspeicher residentes Amiga Basic-Programm wird in 
eine Programmdatei in wählbarem Format auf Disk gespeichert. 

Dateiangabe Ein Zeichenkettenausdruck für eine Dateispezifi¬ 
kation, wie in Kapitel 5.2 beschrieben. SAVE ohne Dateiangabe 
fordert den Anwender in einem Kommunikationsfenster zur 
Eingabe einer Dateiangabe auf. 

A Das Programm wird zeilenweise in Form von ASCII-Zeichen- 
ketten gespeichert (wie LIST auf dem Bildschirm). Wenn A nicht 
angegeben oder wenn B angegeben ist, wird das Programm 
binär gespeichert. 

P Das Programm wird in einem geschützten Format gespei¬ 
chert. 

B Das Programm wird binär gespeichert. 

SAUE "ADRESS" 

Das im Hauptspeicher befindliche Programm wird binär in der 
Datei ADRESS auf die Disk im aktuellen Laufwerk gespeichert. 

SAUE "DF1:SP1EL”,A 

Das im Hauptspeicher befindliche Programm wird im ASCII-For- 
mat in die Datei SPIEL auf die Diskette im Laufwerk DF1: 
gespeichert. 

SAUE "LOHN. FIB", P 

Das hauptspeicherresidente Programm wird als geschützte Da¬ 
tei unter dem Namen LOHN.FIB auf Diskette im aktuellen Lauf¬ 
werk gespeichert. 
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Anmerkungen: • Unter dem spezifizierten Namen im aktuellen Verzeichnis 
bereits existierende Dateien werden durch SAVE über¬ 
schrieben. 


• Fehlt die Laufwerksangabe, so wird auf die Disk (Diskette 
oder Festplatte) im aktuellen Laufwerk gespeichert. 

• Im ASCII-Format gespeicherte Programme können wie se¬ 
quentielle Datendateien gelesen werden. 

• Der MERGE-Befehl (s. dort) verlangt im ASCII-Format ge¬ 
speicherte Programme. 

• Im geschützten Format gespeicherte Programme können 
weder verändert noch gelistet werden. Ein Versuch erzeugt 
die Fehlermeldung 


I I legal function call 


(unerlaubter Funktionsaufruf). Das geschützte Format kann 
nicht mehr rückgängig gemacht werden. 

• Im Diskettenverzeichnis werden Programme im geschützten 
oder im ASCII-Format nicht besonders gekennzeichnet. 
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SAY 

Format: 


Anweisung 


SAY Zelchenkette[,Modus] 

Gibt eine angegebene Zeichenkette von Phonem-Codes in 
verständlicher Sprache beliebiger Nationalität über einen wähl¬ 
baren Tonkanal aus. 

Zeichenkette Ein Zeichenkettenausdruck (Variable oder Kon¬ 
stante), der eine Folge von Phonem-Codes enthält (Phoneme 
sind Spracheinheiten, aus denen sich Silben und Wörter der 
gesprochenen Sprache zusammensetzen. Siehe Anmerkun¬ 
gen). 

Modus Ein Ganzzahlfeld mit mindestens 9 Elementen, das in 
codierter Form die Charakteristiken der auszugebenden Spra¬ 
che in vorgeschriebener Reihenfolge enthält. Folgende Codes 
sind in den einzelnen Feldelementen definierbar: 

Element Beschreibung 

0 Grundfrequenz in Hertz. Es können Werte zwischen 

65 und 320 angegeben werden. Voreingestellt ist ein 
Wert von 110 (normale männliche Sprech-Stimme). 

1 Modulation. Es können zwei Werte angegeben wer¬ 
den: 

0 Silben-Modulation und -Betonung 
(Voreinstellung). 

1 Montone Sprache (roboterhaft). 

Element Beschreibung 

2 Sprechgeschwindigkeit in Worten pro Minute. Es kön¬ 
nen Werte zwischen 40 und 400 angegeben werden. 
Voreingestellt sind 150 Worte/min. 
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3 Geschlecht des Sprechers. Es können zwei Werte 
angegeben werden: 

0 Männliche Stimme (Voreinstellung). 

I Weibliche Stimme. 

4 Dieses Element steuert die Änderungen in der Stimm¬ 
qualität. Es können Werte zwischen 5000 (tief und 
grollend) und 28000 (hoch und quäkig) angegeben 
werden. Voreingestellt ist 22200. 

5 Lautstärke. Es können Werte zwischen 0 (kein Ton) 
und 65 (größte Lautstärke) gewählt werden. Voreinge¬ 
stellt ist 65. 

Element Beschreibung 

6 Ton-Kanal für die Sprachausgabe. Kanäle 0 und 3 
gehen auf den linken, Kanäle 1 und 2 auf den rechten 
Ton-Anschluß. Es können mit folgenden Werten Ka¬ 
nalzuordnungen vorgenommen werden: 

Wert Kanal 

0 Kanal 0 

1 Kanal 1 

2 Kanal 2 

3 Kanal 3 

4 Kanäle 0 und 1 

5 Kanäle 0 und 2 

6 Kanäle 3 und 1 

7 Kanäle 3 und 2 

8 jeder verfügbare linke Kanal 

9 jeder verfügbare rechte Kanal 

10 jedes verfügbare Paar aus rechtem und 
linkem Kanal (Voreinstellung) 

II jeder verfügbare Kanal 
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Beispiel: 


Anmerkungen: 


Element Beschreibung 

7 Synchronisationsmodus. Es können zwei Werte ange¬ 
geben werden: 

0 Synchrone Sprachausgabe. Amiga Basic wartet 
auf die Beendigung der aktuell bearbeiteten 
SAY-Anweisung, ehe weitere Anweisungen bear¬ 
beitet werden (Voreinstellung). 

1 Asynchrone Sprachausgabe. Amiga Basic startet 
die Berabeitung der aktuellen SAY-Anweisung im 
Hintergrund und fährt dann mit der Bearbeitung 
weiterer Anweisungen fort. 

8 Steuerung der Bearbeitung von aufeinanderfolgenden 
SAY-Anweisungen bei asynchroner Sprachausgabe 
^Modus{7) = ^). Es können drei Werte angegeben 
werden: 

0 Normale Verarbeitung. Amiga Basic beendet die 
Berabeitung der aktuellen SAY-Anweisung, ehe 
die nächste SAY-Anweisung begonnen wird (Vor¬ 
einstellung). 

1 Die Bearbeitung der Sprachausgabe wird abge¬ 
brochen. 

2 Die Berarbeitung der aktuellen SAY-Anweisung 
wird abgebrochen und es wird die darauffolgende 
SAY-Anweisung bearbeitet. 

Im Anhang H ist an einem ausführlichen Beispiel die Verwendung 
der SAY-Anweisung für die Ausgabe deutscher Sprache be¬ 
schrieben. 

• Wird für Modus kein Ganzzahlfeld angegeben, so wird der 
Fehler 


Type mismatch 

(fehlende Typübereinstimmung) angezeigt. 

• Wird Modus nicht angegeben, so gelten die oben angege¬ 
ben Voreinstellungen. 

• Sie können Phonem-Codefolgen mit Hilfe der TRANSLA- 
TE$-Funktion (s. dort, nur für angloamerikanische Sprache) 
oder mit den im Anhang H beschriebenen Regeln erzeugen. 
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SCREEN 


Formate: 


Bedeutung: 


■Anweisung 


SCREEN n,Breite,Höhe,Tiefe,Modus 
SCREEN CLOSE n 

Definiert die Attribute (Dimensionen, Anzahl darstellbarer Far¬ 
ben, Auflösung) für einen neuen Bildschirm oder schließt einen 
Bildschirm. 

n Ein ganzzahliger Ausdruck, dessen Wert zwischen 1 und 4 
liegen muß, und der als Kennung für den neuen Schirm gilt. Diese 
Kennung wird in der WINDOW-Anweisung (s. dort) verwendet, 
um anzugeben, in welchem Bildschirm ein spezifiziertes Fenster 
liegen soll. 

Breite Ein ganzzahliger Ausdruck, dessen Wert zwischen 1 und 
640 liegen muß, und der die Breite des Bildschirmes in Bildpunk¬ 
ten angibt. 

Höhe Ein ganzzahliger Ausdruck, dessen Wert zwischen 1 und 
400 liegen muß, und der die Flöhe des Bildschirmes in Bildpunk¬ 
ten angibt. 

Tiefe Ein ganzzahliger Ausdruck, dessen Wert zwischen 1 und 5 
liegen muß, und der die Anzahl der Bit-Ebenen für den Bild¬ 
schirm festlegt. Die Anzahl der Bit-Ebenen bestimmt die Anzahl 
der auf dem Bildschirm darstellbaren Farben nach folgender 
Tabelle: 

Tiefe Anzahl Farben 

1 2 

2 4 

3 8 

4 16 

5 32 
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Beispiel: 


Anmerkungen: 


Modus Ein ganzzahliger Ausdruck, dessen Wert zwischen 1 
und 4 liegen muß, und der die Auflösung und die Bildschirmdar¬ 
stellung nach folgender Tabelle festlegt: 

Modus Bildschirm 

1 320 Bildpunkte/Zeile bei 200 Zeilen (ohne 
Zeilensprungverfahren). 

2 640 Bildpunkte/Zeile bei 200 Zeilen (ohne 
Zeilensprungverfahren). 

3 320 Bildpunkte/Zeile bei 400 Zeilen (mit Zei¬ 
lensprungverfahren) . 

4 640 Bildpunkte/Zeile bei 400 Zeilen (mit Zei¬ 
lensprungverfahren). 

SCREEN CLOSE n schließt den angegebenen Bildschirm und 
gibt den dafür reservierten Bit-Speicher wieder frei. 

SCREEN 1,320,200,5, 1 

WINDOW 2, "Zei len", < 10, 10)-(270, 170), 15, 1 

Es wird ein Bildschirm mit der Kennung 1, niedriger Auflösung 
mit 320x200 Bildpunkten, einerTiefe von 5 für die Darstellung von 
32 Farben ohne Zeilensprungverfahren definiert, in dem ein 
Fenster mit der Kennung 2 und dem Titel Zeilen zwischen den 
Koordinaten 10,10 für die obere linke Ecke und 270,170 für die 
untere rechte Ecke geöffnet wird. Das Fenster kann mit Hilfe der 
Maus vergrößert oder verkleinert, gezogen, in den Hintergrund 
oder Vordergrund gestellt sowie geschlossen werden (s.a. WIN- 
DOW-Anweisung). 

• Jede SCREEN-Anweisung reserviert für den spezifizierten 
Bildschirm einen Bit-Speicher, dessen Größe von den 
Schirmdimensionen abhängt. 

• Ist der Amiga an ein Fernsehgrät angeschlossen, so wird 
üblicherweise niedrige Auflösung (320 Bildpunkte/Zeile) ge¬ 
wählt, bei Monochrom- oder RGB-Monitoren dagegen hohe 
Auflösung. 

• Beim Zeilensprungverfahren (auch Zwischenzeilenabta¬ 
stung genannt) wird die Anzahl horizontaler Bildzeilen ver¬ 
doppelt, was aber unter Umständen zu einem leichten Flim¬ 
mern des Bildes führen kann. 
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SCROLL 

Format: 

Bedeutung: 


Anmerkungen: 


■Anweisung 


SCROLL (x1,y1)-(x2,y2) , deltax,deltay 

Rollt einen definierten, rechteckigen Bereich im aktuellen Ausga¬ 
befenster in eine wählbare Richtung. 

x1,y1 Absolute Bildschirmkoordinaten der linken oberen Ecke 
des zu rollenden Bereiches. 

x2,y2 Absolute Bildschirmkoordinaten der rechten unteren 
Ecke des zu rollenden Bereiches. 

deltax Ein numerischer Ausdruck, dessen ganzzahliger Wert 
die Anzahl der Bildpunkte angibt, um die nach rechts (deltax 
positiv) oder links (deltax negativ) gerollt werden soll. 

deltay Ein numerischer Ausdruck, dessen ganzzahliger Wert 
die Anzahl der Bildpunkte angibt, um die nach unten (deltay 
positiv) oder oben (deltay negativ) gerollt werden soll. 

• Die SCROLL-Anweisung ist am effektivsten, wenn das zu 
rollende Bild kleiner als das definierte Rechteck ist, und in 
den betroffenen Bildschirmbereichen im Hintergrund keine 
Darstellungen vorhanden sind. 
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SGN-Funktion 


Format: y=SGN(x) 

Bedeutung: Es wird das Vorzeichen des Wertes eines beliebigen numeri¬ 

schen Ausdruckes in Form einer Konstanten übergeben. 

x Ein beliebiger numerischer Ausdruck. 

Es gilt: 

für jr<0: SGN(jr) =-1 
für jr=0: SGN(x) = 0 
für jr>0: SGN(*) = 1 

Beispiel: if sgncr) then NichtNui l 

PRINT "ft ist Null": END 


NichtNuiI: 


Das Programm verzweigt nur nach Zeile NichtNull:, wenn der 
Wert von A positiv oder negativ ist. 
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SHARED 

Format: 

Bedeutung: 

Beispiel: 

Anmerkungen: 


Anweisung 


SHARED Variable, Variable}.... 

Definiert innerhalb eines Unterprogramms die angegebenen 

Variablen als globale Variablen. 

Variable Eine beliebige Variable oder Feldvariable, die als global 

für Haupt- und Unterprogramm definiert werden soll. Feldvariab¬ 
len müssen ein Paar runde Klammern () folgen. 

Siehe Kapitel 6.1. 

• Globale Variable sind Variablen, deren Werte sich im Haupt¬ 
programm analog ändern, wenn sie im Unterprogramm ge¬ 
ändert werden und umgekehrt. Normalerweise sind alle in 
Unterprogrammen deklarierten Variablen zunächst lokal, 
also nur für das betreffende Unterprogramm gültig. 

• Die SHARED-Anweisung darf nur in Unterprogrammen ver¬ 
wendet werden, kann dort aber mehrfach Vorkommen. 

• Es ist guter Programmierstil, alle SHARED-Anweisungen 
eines Unterprogrammes an dessen Anfang zu stellen. 

• Die Dimensionierung globaler Felder mit der DIM SHARED- 
Anweisung (s. dort) muß jedoch im Hauptprogramm erfol¬ 
gen. 
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SIN-Funktion 


Format: y=SIN(x) 

Bedeutung: Es wird der Sinus des Wertes des numerischen Ausdruckes x 

berechnet und übergeben. Ist das Argument einfach genau, 
erfolgt die Berechnung einfach-genau, ist es doppelt-genau, so 
wird auch ein doppelt-genauer Wert übergeben. 

x Winkel im Bogenmaß. 


Beispiel: pi=3 .141593 

WIMKEL=180 

RRDIRNS=UINKEL»PI/18B 
PRINT SIN(RRDIRNS) 


Wird dieses Programm gestartet so ergibt sich die Anzeige 

a 

Ok 


Um den Sinus des Winkels von 180 Grad zu ermitteln, wird der 
Winkel in der dritten Programmzeile ins Bogenmaß umgerech¬ 
net. 

Anmerkungen: • Weitere trigonometrische Funktionen sind COS und TAN (s. 
dort). 

• Im Anhang E sind die transzendenten Funktionen zusam¬ 
mengestellt, die mit Hilfe der vorhandenen Amiga Basic- 
Funktionen umschrieben werden können. 
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SLEEP-Anweisung 


Format: SLEEP 

Bedeutung: Ein Amiga Basic-Programm wird angehalten, bis eines der 

folgenden Ereignisse eintritt. 

• Betätigung der Auswahltaste der Maus 

• Betätigung einer Tastaturtaste 

• Kollision grafischer Objekte 

• Auswahl eines Menü-Titels 

• Ablauf einer vorgegebenen Zeit (TIMER) 

Beispiel: UarteTaste: 

i$=INKEY$ 

IF THEN STOP 

SLEEP 

GOTO WarteTaste 


Es wird auf das Drücken einer Taste gewartet. Nur wenn es die 
Taste * ist, wird das Programm abgebrochen. 
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SOUND 


Formate: 


Bedeutung: 


Anweisung 


SOUND Frequenz,Dauei[,[Laui\[, Kanal]] 

SOUND WAIT 
SOUND RESUME 

Es wird ein Ton einer wählbaren Frequenz, Dauer und Lautstärke 
in einer Ton-Warteschlange abgelegt, die über einen wählbaren 
Ton-Kanal abgespielt wird. Das Abspielen der Warteschlange 
kann außerdem angehalten oder fortgesetzt werden. 

Frequenz Eine beliebige numerische Ganzahl- oder Fest¬ 
punkt-Konstante (letztere in einfacher oder doppelter Genauig¬ 
keit), deren Wert im Bereich zwischen 20 und 15000 liegen muß 
und die gewünschte Frequenz in Hertz definiert. Liegt er unter 
20, erzeugt Amiga Basic einen Ton von 20 Hertz, liegt er über 
15000, erzeugt Amiga Basic einen Ton von 15000 Hertz (s. 
Anmerkungen). 

Dauer Ein beliebiger numerischer Ausdruck, dessen Wert im 
Bereich zwischen 0 und 77 liegen muß und der die Tondauer in 
Zeittakten definiert. Eine Sekunde entspricht der Dauer von 18,2 
Zeittakten (s. Anmerkungen). 

Laut Ein numerischer Ausdruck, dessen ganzzahliger Wert 
zwischen 0 (kleinste Lautstärke) und 255 (größte Lautstärke) 
liegen muß und der die Lautstärke des Tones angibt. Voreinge¬ 
stellt ist hier 127. 

Kanal Ein numerischer Ausdruck, dessen ganzzahliger Wert 
zwischen 0 und 3 liegen muß. Ein Wert von 0 oder 3 definiert für 
diese beiden Tonkanäle den linken, ein Wert von 1 oder 2 für 
diese Tonkanäle den rechten Tonausgang des Amiga. Voreinge¬ 
stellt ist hier der Wert 0 (Null). 

SOUND WAIT Nach dieser Anweisung werden die Ergebnisse 
aller folgenden SOUND-Anweisungen in einer Warteschlange 
abgelegt, bis eine SOUND RESUME-Anweisung ausgeführt 
wird. Dies dient zur Synchronisation der Töne aus allen vier 
Amiga-Tonkanälen. Da die Ton-Warteschlange begrenzt ist, 
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Beispiel: 


Anmerkungen: 


kann das Ansammeln von zu vielen Tönen in der Warteschlange 
ohne SOUND RESUME-Anweisung zu der Fehleranzeige 


Out of Memory 


(Hauptspeicher nicht ausreichend) führen. 


FOR 1=440 TO 1000 STEP S 
SOUND 1,1.5 
NEXT 

FOR I = 1000 TO 440 STEP -5 
SOUND 1,1.5 
NEXT 

Durch dieses Programm wird ein auf- und abschwellendes 
Glissando mittlerer Lautstärke erzeugt und von Kanal 0 über den 
linken Tonausgang ausgegeben. 

• Die beiden folgenden Tabellen geben die Frequenzen für 
zwei Oktaven vor und nach dem kleinen c sowie die verschie¬ 
denen Tempi in Abhängigkeit von den Zeittakten: 


Note 

Frequenz 

Note 

Frequenz 

C 

130.810 

c 

523.250 

D 

146.830 

D 

587.330 

E 

164.810 

E 

659,260 

F 

174.610 

F 

698.460 

G 

196.000 

G 

783.990 

A 

220.000 

A 

880.000 

H 

246.940 

H 

987.770 

C 

261.630 

C 

1046.500 

D 

293.660 

D 

1174.700 

E 

329.630 

E 

1318.500 

F 

349.230 

F 

1396.900 

G 

392.000 

G 

1568.000 

A 

440.000 

A 

1760.000 

H 

493.880 

H 

1975.500 



9-230 


Befehle, Anweisungen und Funktionen 


Tempo 

Takte/ 

Einheiten/ 


Minute 

Takt 

Larghissimo 

40- 60 

28.13-18.75 

Largo 

60- 66 

18.75-17.05 

Larghetto 

Grave 

Lento 

Adagio 

66- 76 

17.05-14.8 

Adagietto 

Andante 

76-108 

14.8-10.42 

Andantino 

Moderato 

108-120 

10.42-9.38 

Allegretto 

Allegro 

120-168 

9.38- 6.7 

Vivace 

Veloce 

Presto 

Prestissimo 

168-208 

6.7 - 5.41 


• Höhere oder tiefere Noten können durch Verdoppelung oder 
Halbierung der Frequenz der betreffenden Note in der 
nächsttieferen oder nächsthöheren Oktave angenähert wer¬ 
den. 

• Bei aufeinanderfolgenden SOUND-Anweisungen wird eine 
Folgeanweisung erst ausgeführt, wenn die vorhergehende 
Anweisung mit ihrer vollen Dauer abgearbeitet ist. 

• Die Vielseitigkeit der SOUND-Anweisung kann mit Hilfe der 
WAVE-Anweisung (s. dort), mit der die Tonwellenform fest¬ 
gelegt werden kann, erheblich erweitert werden. 
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SPACE$-Funktion 


Format: v$=SPACE$(/i) 

Bedeutung: Es wird eine Zeichenkette, die aus einer wählbaren Anzahl von 

Leerstellen besteht, übergeben. 

n Ein ganzzahliger Ausdruck, dessen Wert im Bereich zwischen 
0 und 32767 liegen muß. 

Beispiel: ft$="zwiscHEN”*spflCE$(4)+"Rftuii” 

PRINT A$ 

ZWISCHEN RAUM 
Ok 

Anmerkungen: • Siehe auch SPC-Funktion. 
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SPC-Funktion 


Format: SPC(n) 

Bedeutung: Es wird eine wählbare Anzahl von Leerstellen auf dem Ausgabe¬ 

gerät (Bildschirm, Drucker, sequentielle Datei) ausgegeben. 

n Ein ganzzahliger Ausdruck, dessen Wert im Bereich zwischen 
0 und 255 liegen muß. 

Beispiel: print "zwiscHEM"spc(4)"RHun" 

ergibt im Ausgabefenster 

ZWISCHEN RAUM 
Ok 

Steht die SPC-Funktion am Ende einer Liste von Ausdrücken in 
einer PRINT-Anweisung, so wird hier kein Wagenrücklauf/Zei¬ 
lenvorschub erzeugt. 

Anmerkungen: • Die SPC-Funktion darf nur in Verbindung mit PRINT-, PRINT #- 
und LPRINT-Anweisungen verwendet werden. 


• Siehe auch SPACES-, PTAB- und TAB-Funktionen. 
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SQR-Funktion 


Format: ir=SQR(jr) 

Bedeutung: Es wird die Quadratwurzel des Wertes eines numerischen Aus¬ 

druckes je nach Genauigkeit des Argumentes mit einfacher oder 
doppelter Genauigkeit berechnet. Der Wert muß größer oder 
gleich Null sein. 

x Beliebiger numerischer Ausdruck mit positivem Wert. 
Beispiel: for 1 = 0 to 9 step 3 

PRINT I.SQRII ) 

NEXT 

ergibt im Ausgabefenster 

e b 

3 1.732051 

6 2.44949 

9 3 

Ok 
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STICK- 

Format: 

Bedeutung: 


Funktion 


v= STICK(/I) 

Liefert den Zustand eines wählbaren, angeschlossenen Joy¬ 
sticks (Spielpult, Steuerknüppel). 

n Ein ganzzahliger Ausdruck, dessen Wert zwischen 0 und 3 
liegen muß, und der festlegt, welche Information von welchem 
Joystick abgefragt werden soll: 

n Joystick und Richtung 

0 Joystick A in X-Richtung 

1 Joystick A in Y-Richtung 

2 Joystick B in X-Richtung 

3 Joystick B in Y-Richtung 

STICK(n) liefert einen der folgenden Werte als Richtungsindi¬ 
kator: 

1 Bewegung nach oben oder rechts 
0 Jystick wird nicht betätigt 
-1 Bewegung nach unten oder links 



Befehle, Anweisungen und Funktionen 


9-235 


STOP-Anweisung 


Format: STOP 

Bedeutung: Die Programmausführung wird unterbrochen, und Amiga Basic 

kehrt auf die Befehlsebene (Direktmodus) zurück. Das Pro¬ 
gramm kann durch Eingabe des CONT-Befehls (s. dort) fortge¬ 
setzt werden. 


Beispiel: PI=3.1-!1593:D=10 

PRINT "Kre isf 1 aeche ist*'; PI*Dt2/4 
STOP 

PRINT "Kreisumfang ist";PI*D 


ergibt im Ausgabefenster: 


KreisfIaeche i st 78.53983 

Ok 

cont (wird im Direktmodus eingegeben) 

Kreisumfang ist 31.41593 

Ok 

Anmerkungen: • Die STOP-Anweisung kann an beliebigen Stellen in ein 
Programm zum Testen eingefügt werden, um z.B. den Wert 
von bestimmten Variablen zu überprüfen. 

• Die STOP-Anweisung schließt im Gegensatz zur END-An- 
weisung (s. dort) keine geöffneten Dateien, 

• Die STOP-Anweisung hat dieselbe Wirkung wie das Wählen 
von Stop aus dem Run-Menü. 
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STR$-Funktion 


Format: ir5=STR$(x) 

Bedeutung: Es wird der Wert eines numerischen Ausdrucks als Zeichenkette 

übergeben. 

x Ein beliebiger numerischer Ausdruck. 

Beispiel: a= 12 . 4 s :print str$(A),len(str$(A)) 

12.4S 6 

Ok 

Anmerkungen: • Der Zeichenkette eines positiven Wertes wird immer anstelle 
des Vorzeichens eine Leerstelle vorangestellt. 


• Die Umkehrfunktion von STRS ist die VAL-Funktion (s. dort). 
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STRIG-Funktion 


Format: v=STRIG(r7) 

Bedeutung: Es wird je nach Argument n der Status des Feuerknopfes eines 

wählbaren Joysticks übergeben. 

n Ein ganzzahliger Ausdruck, dessen Wert im Bereich zwischen 

0 und 3 liegen muß, und der folgende Bedeutung hat: 

0 Es wird 1 übergeben, falls der Knopf von Joystick A seit der 
letzten Abfrage mit STRIG(O) gedrückt wurde, sonst 0. 

1 Es wird 1 übergeben, falls der Knopf von Joystick A gerade 
gedrückt ist, sonst 0. 

2 Es wird 1 übergeben, falls der Knopf von Jystick B seit der 
letzten Abfrage mit STRIG(2) gedrückt wurde, sonst 0. 

3 Es wird 1 übergeben, falls der Knopf von Joystick B gerade 
gedrückt ist, sonst 0. 
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STRING$-Funktion 


Format: p$=STRING$(/>,/n) 

k 5= STRING$(/?,x5) 

Bedeutung: Es wird eine Zeichenkette gleicher Zeichen wählbarer Länge n 

übergeben, die entweder aus Zeichen eines wählbaren ASCII- 
Codes m oder aus dem Anfangszeichen einer spezifizierten 
Zeichenkette x$ besteht. 

n Ganzzahliger Ausdruck, dessen Wert im Bereich zwischen 0 
und 32767 liegen muß. 

m Ganzzahliger Ausdruck, dessen Wert im Bereich zwischen 0 
und 255 liegen muß. 

x$ Ein beliebiger Zeichenkettenausdruck. 

Beispiel 1: u$=string$(9,42) 

PHINT "Betrag: "u$ 

ergibt im Ausgabefenster 

BETRAG:jhhhhhhh(# 

Ok 

Zwischen dem Text und der Variablen u$ braucht kein Semikolon 
angegeben zu werden, da das zweite Anführungszeichen als 
Trennmerkmal gilt. 

Beispiel 2: PRINT STRING$C5, "Xantippe" ) 

ergibt im Ausgabefenster 


xxxxx 

Ok 
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SUB-Anweisung 


Formate: SUB Name[(Uste form. Param.)] STATIC 

END SUB 
EXIT SUB 

Bedeutung: Leitet ein Amiga Basic-Unterprogramm ein, beendet es bzw. 

erlaubt den Unterprogramm-Aussprung. 

Name Jeder beliebige Name bis zu einer Länge von 40 Zeichen 
nach den Amiga Basic- Namensregeln (s. Kapitel 8.3 und 8.5). 
Dieser Name darf in keiner anderen SUB-Anweisung verwendet 
werden. 

Liste form. Param. Hier dürfen einfache oder Feld-Variablen 
angegeben werden. Bei mehreren Einträgen sind diese durch 
Kommata voneinander zu trennen. Die Anzahl der Einträge wird 
nur durch die maximale Länge einer logischen Amiga Basic-Pro- 
grammzeile (254 Zeichen) begrenzt. Werden Feld-Variablen 
angegeben, so muß dies durch ein Paar runder Klammern () 
gekennzeichnet werden. Innerhalb der Klammern kann die An¬ 
zahl der Dimensionen des Feldes, nicht die einzelnen Dimensio¬ 
nen selbst, angegeben werden. 

STATIC besagt, daß alle Variablen im Unterprogramm ihre Werte 
zwischen zwei Unterprogrammaufrufen behalten. Die Werte von 
mit STATIC deklarierten Variablen können nicht vom Hauptpro¬ 
gramm verändert werden. Außerdem bedeutet der STATIC- 
Zusatz, daß das betreffende Unterprogramm nicht rekursiv ist, 
d.h. sich nicht selbst, noch ein anderes Unterprogramm aufrufen 
darf, das dann seinerseits das aufrufende Unterprogramm wie¬ 
der aufruft. 

END SUB bezeichnet das Ende eines Unterprogrammes und 
übergibt die Programmsteuerung an die Anweisung, die dem 
Unterprogrammaufruf im Hauptprogramm folgt. 

EXIT SUB erlaubt die Beendigung eines Unterprogramms in 
dessen Mitte und die Übergabe der Programmsteuerung an die 
Anweisung, die dem Unterprogrammaufruf im Hauptprogramm 
folgt. 
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Beispiel: 

Anmerkungen: 


Siehe Kapitel 6.1 

• Ehe Amiga Basic ein Unterprogramm ausführt, werden alle 
damit zusammenhängenden Anweisungen formal überprüft. 
Werden Fehler gefunden, so wird das Unterprogramm nicht 
ausgeführt. Diese Fehler sind nicht mit einer Fehleroutine 
programmiert verarbeitbar, noch existieren Fehlercodes. Sie 
werden vielmehr in einem Fehler-Kommunikationsfenster 
angezeigt. Es gibt folgende Fehlermeldungen, die sich auf 
die formale Überprüfung eines Unterprogramms beziehen: 


Tr* i ed to dec Iare a SUB wiihirt a SUB 


Versuch, SUB innerhalb einer SUB-Struktur zu deklarieren. 


SUB a 1 ready def ined 


SUB bereits deklariert 


Missing STftTIC in SUB-Statemeni 


in SUB-Anweisung fehlt STATIC-Zusatz 


EXIT SUB outs ide of a subprogramm 


EXIT SUB-Anweisung außerhalb eines Unterprogramms 


END SUB outside of a subprogramm 


END SUB-Anweisung außerhalb eines Unterprogramms 


SUB uithout an END SUB 


END SUB-Anweisung fehlt in einer SUB-Struktur 
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SHPRED outside of a subprogramm 

SHARED-Anweisung außerhalb eines Unterprogramms. 


• In Kapitel 6.1 wird die Verwendung von Amiga Basic-Unter- 
programmen ausführlich, auch an Hand von Beispielen, 
erläutert. 


• Siehe auch CALL- und SHARED-Anweisungen 
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SWAP-Anweisung 


Format: SWAP Var1,Var2 

Bedeutung: Die Werte zweier beliebiger Variablen gleichen Typs werden 

miteinander vertauscht. 

Var1,Var2 Zwei Namen für beliebige Variablen oder Feldele¬ 
mente, die im Typ und ggf. in der Genauigkeit übereinstimmen 
müssen. 

Beispiel: x$="rock” :y$=”nacht" 

PRINT X$Y$:SWAP X$,y$:PRINT X$Y 

ergibt folgende Anzeige im Ausgabefenster: 

ROCKNACHT 

NACHTROCK 

Ok 

Anmerkungen: • Bei fehlender Typ- oder Genauigkeitsübereinstimmung wird 

die Fehlermeldung 

Type mismatch 

(keine Typübereinstimmung) ausgegeben. 
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SYSTEM-Befehl 


Format: SYSTEM 

Bedeutung: Rückkehr aus Amiga Basic zum Arbeitstisch (Workbench) oder 

auf die Befehlsebene (CLI) des AmigaDOS-Betriebssystems. 

Anmerkungen: • SYSTEM schließt alle offenen Dateien. 

• der SYSTEM-Befehl hat dieselbe Wirkung wie die Wahl von 
QUIT im Project-Menü. 

• Amiga Basic prüft vor der Ausführung des SYSTEMS-Be- 
fehl, ob das Programm seit der letzten Speicherung verän¬ 
dert wurde. Ist dies der Fall, so wird der Anwender in einem 
Kommunikationsfensterzu einer Entscheidung aufgefordert, 
ob er das Programm vorher noch speichern möchte oder 
nicht. 
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TAB-Funktion 


Format: TAB(n) 

Bedeutung: Die Zeile auf dem Ausgabegerät (Bildschirm, Drucker, sequen¬ 

tielle Datei) wird von der augenblicklichen bis zur definierten 
Druckposition mit Leerstellen aufgefüllt (Tabulator). 

n Ein ganzzahliger Ausdruck, dessen Wert zwischen 1 und 255 
liegen muß. 

Beispiel: drtr "bononen", "3.99": read n$, p$ 

PRINT "Ohst”TflB(20) , ’kg—Preis" : PRINT 
PRINT A$TnB(20)P$ 

ergibt im fiusgabef enster die Anzeige 
Obst kg—Preis 

Bananen 3.99 

Ok 

Anmerkungen: • Die TAB-Funktion darf nur in Verbindung mit den PRINT-, 
PRINT # - und LPRINT-Anweisungen verwendet werden. 

• Wenn die aktuelle Druckposition rechts von der durch n 
spezifizierten Position liegt, wird an die Position n in der 
nächsten Zeile tabuliert. 

• Die Spalte 1 ist die äußerst linke Druckposition. Die äußerst 
rechte ist durch die WIDTH-Einstellung definiert. 

• Steht die TAB-Funktion am Ende einer Liste von Ausdrük- 
ken, so wird kein Wagenrücklauf/Zeilenvorschub ausgeführt. 


• Siehe auch PTAB- und SPC-Funktionen. 
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TAN-Funktion 


Format: ir=TAN(x) 

Bedeutung: Es wird der Tangens des Wertes des numerischen Ausdruckes x 

berechnet und übergeben. Ist das Argument einfach-genau, 

erfolgt die Berechnung mit einfacher, ist es doppelt-genau, mit 
doppelter Genauigkeit. 

x Winkel im Bogenmaß. 

Beispiel: pi=a .141593 

UINKFI=4S:RPDIANS=UINKEL*PI/180 
PRINT TONC RftDI ANS) 

ergibt im Ausgabefenster die Anzeige 

1 

Ok 

Um den Tangens eines Winkels von 45 Grad zu berechnen, wird 
der Winkel zunächst ins Bogenmaß umgerechnet. 

Anmerkungen: • Tritt beim Tangens Überlauf ein, so meldet der Interpreter 
dies mit 

Overf I oui 

(Überlauf), übergibt als Ergebnis die für ihn größte mögliche 
Zahl mit dem entsprechenden Vorzeichen und führt das 
Programm fort. 


• Siehe auch COS- und SIN-Funktionen. 
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TIME$-Systemvariable 


Format: v$= TIMES 

Bedeutung: Die laufende Zeit wird von der Systemuhr abgerufen und als 

Zeichenkette von 8 Bytes Länge im Format hh.mm.ss überge¬ 
ben. hh liegt im Bereich 00 bis 23, mm und ss im Bereich 00 bis 
59. 

Beispiel: lee locote i, i:printtime$:goto 100 


Die laufende Zeit wird in der oberen linken Ecke des aktuellen 
Ausgabefensters angezeigt. 
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TIMER-Anweisung 


Formate: TIMER ON 

TIMER OFF 
TIMER STOP 

Bedeutung: Die Unterbrechungsreaktionsfähigkeit für Zeitablauf wird akti¬ 

viert oder inaktiviert. 


Beispiel: Siehe ON TIMER-Anweisung für ein ausführliches Beispiel. 


Anmerkungen: • TIMER ON aktiviert die Unterbrechungsreaktionsfähigkeit 
für Zeitablauf. In einem Programm prüft der Interpreter dann 
vor jeder neuen Anweisung, ob eine definierte Zeit abgelau¬ 
fen ist und verzweigt ggf. zu der in der ON Timer(n) GO- 
SUB-Anweisung (s. dort) angegebenen Subroutine. 

• Eine TIMER-Anweisung darf nicht vor einer ON TIMER(n) 
GOSUB-Anweisung im Programm stehen. 

• TIMER OFF inaktiviert die Unterbrechungsreaktionsfähig¬ 
keit. Unterbrechungen durch Zeitablauf sind nach dieser 
Anweisung dann nicht mehr möglich. 


• TIMER STOP inaktiviert zunächst auch die Unterbrechungs¬ 
reaktionsfähigkeit. Die Unterbrechung beim Ablauf einer 
definierten Zeit erfolgt jedoch sofort, sobald die Anweisung 
TIMER ON ausgeführt wird. 


• S a. TIMER-Funktion sowie Kapitel 6.4 “Verarbeitung von 
Unterbrechungsereignissen“. 
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TIMER-Funktion 

Format: v= TIMER 

Bedeutung: Es wird die Anzahl der Sekunden, die seit Mitternacht oder dem 

Wiederanlauf des Rechnersystems vergangen sind, als Wert 
einfacher Genauigkeit übergeben. 

Anmerkungen: • TIMER kann nicht vom Anwender gesetzt werden. 


• Die TIMER-Funktion kann als Anfangswertgeber bei der 
RANDOMIZE-Anweisung (s. dort) verwendet werden. 
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TRANSLATE$-Funktion 


Format: vS =TRANSLATE$( Text) 


Bedeutung: Erzeugt und übergibt eine Folge von Phonemcodes für die 

SAY-Anweisung (s. dort) aus einer angloamerikanischen Text- 
Zeichenkette. 

Text Ein Zeichenkettenausdruck, dessen Wert ein Text in 
angloamerikanischer Sprache sein muß und der als Sprache mit 
der SAY-Anweisung ausgegeben werden soll. 

Beispiel: a$=TRANSLATE$( ” I ' m the Rm iga Computer") 

SftY a$ 

Anmerkungen: • TRANSLATES kann eine Phonem-Zeichenkette von maximal 
32767 Zeichen erzeugen. 

• Im Anhang H ist die Verwendung der TRANSLATE$-Funkti- 
on sowie der SAY-Anweisung ausführlich beschrieben. An¬ 
hand eines Beispielprogramms wird dort auch gezeigt, wie 
deutsche Sprache erzeugt werden kann. 
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TRON- und TROFF-Befehle 


Formate: TRON 

TROFF 

Bedeutung: Der Programmablauf wird durch den Befehl TRON im List-Fen¬ 

ster protokolliert. Dabei wird vor der Ausführung einer Anwei¬ 
sung diese mit einem orangefarbenen Rechteck eingerahmt im 
List-Fenster angezeigt, falls das List-Fenster sichtbar ist. Der 
Befehl TROFF schaltet diese Programmablaufverfolgung wieder 
aus. 

Anmerkungen: • Die TRON- und TROFF-Befehle dienen zum schrittweisen 
Austesten von Programmen. Sie haben dieselbe Wirkung 
wie die Wahl des Trace On/Off-Schalters im Run-Menü (s.a. 
Kapitel 3.4). 
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UBOUND-Funktion 


Siehe LBOUND-Funktion 
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UCASE$ 

Format: 

Bedeutung: 


Beispiel: 


Anmerkungen: 


Funktion 


v$= UCASE $(*$) 

Übergibt eine Kopie einer angegebenen Zeichenkette, in der alle 
Kleinbuchstaben in Großbuchstaben gewandelt werden. 

x$ Beliebiger Zeichenkettenausdruck, der in gleicher Länge 
übergeben wird, nachdem vorher alle Kleinbuchstaben in Groß¬ 
buchstaben gewandelt wurden. 

LINE INPUT "Weiter C j^n) ? " ; «$ 

IF UCftSE$C «$> = ’’J" THEN Weiter 
END 


We iter: 


Auf die Abfrage könnte der Anwender sowohl mit j als auch mit J 
antworten. Mit Hilfe der UCASE$-Funktion können beide Fälle 
berücksichtigt werden. 

• UCASE$ ist vor allem hilfreich, wenn Textdaten sortiert 
werden sollen, da ja Klein- und Großbuchstaben gleich 
sortiert werden sollen, aber unterschiedliche ASCII-Codes 
haben. Mit UCASE$ können solche Daten für die Sortierung 
umgewandelt werden, ohne die Originaldaten verändern zu 
müssen. 
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VAL-Funktion 


Format: v= VAL(xJf) 

Bedeutung: Der Wert eines Zeichenkettenausdruckes wird in Form des 

numerischen Äquivalentes übergeben. 

x$ Ein beliebiger Zeichenkettenausdruck. 

Beispiel 1: a$=" 12 . 4 s" : pri nt ual< n$ •> 

12 . 4 s 

Ok 

Beispiel 2: ft$="Preis DM 8.90'’:PRII1T UAL(A$) 

B 

Ok 

Anmerkungen: • Beginnt der Zeichenkettenausdruck mit einem anderen Zei¬ 
chen als einer Ziffer, dem Punkt (.) oder dem Plus- ( 4 -) bzw. 
Minus-Zeichen (-), so übergibt VAL eine Null (0). 

• VAL ignoriert alle Leerstellen, Tabulatoren und Zeilenvor¬ 
schubcodes in der Zeichenkette. 

• Außer den oben genannten Zeichen am Anfang der Zeichen¬ 
kette akzeptiert VAL noch die Buchstaben E und D in der 
Zeichenkette (z.B. VAL(“3E-12“)). 


• Die Umkehrfunktion von VAL ist die STR$-Funktion (s. dort). 
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VARPTR 

Format: 

Bedeutung: 


Beispiel: 


Anmerkungen: 


Funktion 


v= VAR PTR ( Variable) 

Die VARPTR-Funktion liefert die Flauptspeicheradresse im Be¬ 
reich zwischen 0 und 16777215 des ersten Datenbytes einer 
beliebigen Variablen oder eines Feldvariablenelementes. 

Variable Eine beliebige Variable oder ein beliebiges Feldvariab¬ 
lenelement, der/dem ein Wert zugewiesen sein muß. 

BXX=1024 

UP=UfiRPTRCBXaO 

OX=PEEKWCUP) 

Zunächst wird VP die Adresse der Ganzzahlvariablen BX% 
zugewiesen. Die Daten, die in dieser Variablen gespeichert sind, 
werden dann mit PEEKW (s. dort) gelesen. 

• Bei Zeichenkettenvariablen übergibt VARPTR die Adresse 
der ersten Bytes des Zeichenkettendeskriptors, also der 
Länge der Zeichenkette. Die folgenden Bytes enthalten dann 
die Adresse der Zeichenkette selbst. Da sich das Deskriptor¬ 
format in zukünftigen Versionen von Amiga Basic ändern 
kann, ist hier besser die SADD-Funktion (s. dort) zu verwen¬ 
den. 

• Die VARPTR-Funktion eignet sich besonders zum Überge¬ 
ben von Variablenadressen an Maschinensprache-Unter¬ 
programme. 

• Wird VARPTR für ein Feldvariablenelement verwendet, soll¬ 
ten alle einfachen Variablen vorher definiert sein, damit sich 
die Feldelementadressen nicht bei jeder neuen einfachen 
Variablendefinition ändern. 

• Wenn ein Feld an ein Maschinensprache-Unterprogramm 
übergeben werden soll, wird üblicherweise z.B. mit VARPTR 
(A(0)) Die Anfangsadresse des ersten Elementes über¬ 
geben. 
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• Die Verwendung der VARPTR-Funktion in Verbindung mit 
Maschinensprache-Unterprogrammen ist ausführlich in Ka¬ 
pitel 6.2 beschrieben. 

• Wurde der in einem VARPTR-Aufruf deklarierten Variablen 
noch kein Wert zugewiesen, so wird die Fehlermeldung 

I 1legaI Funciion call 

(unerlaubter Funktionsaufruf) angezeigt. 
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WAVE-Anweisung 


Format: WAVE Kanal,Definition 

Bedeutung: Definiert die Form von Tonwellen für einen angegebenen Tonka¬ 

nal. 


Kanal Ein numerischer Ausdruck, dessen ganzzahliger Wert im 
Bereich zwischen 0 und 3 liegen muß, und der den Ton-Kanal 
des Amiga angibt, über den die Ton-Welle mit der SOUND-An- 
weisung (s. dort) ausgegeben werden soll. 0 oder 3 beziehen 
sich auf den linken, 1 oder 2 auf den rechten Ton-Ausgang des 
Amiga. 

Definition Entweder das Schlüsselwort SIN oder ein numeri¬ 
sches Feld mit mindestens 256 Elementen. Jedes Element darf 
einen ganzzahligen Wert zwischen -128 und 127 annehmen und 
definiert eine Amplitude. Die Aneinanderreihung dieser Amplitu¬ 
denwerte ergibt die Tonwellenform. 


Beispiel: defihtä-z 

DIM timbre 
FOR i = 0 TO 255 
READ t imbre 
NEXT 

WAUE 0, SIN 
WAUE 1, timbre 
WAUE 2, iimbre 
WAUE 3, timbre 


Anmerkungen: • Nach der Ausführung der WAVE-Anweisung sollte mit der 
ERASE-Anweisung das Wellenformfeld wieder gelöscht 
werden, um Speicherplatz zu sparen. 
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WHILE . 


Format: 


Bedeutung: 


Beispiel: 


Anmerkungen: 


.. WEND-Anweisungen 


WHILE Ausdruck 


Anweisungen 


WEND 

Eine beliebige Anzahl von Anweisungen, die in beliebig vielen 
Programmzeilen stehen können, wird in einer Schleife so oft 
ausgeführt, wie ein angegebener Ausdruck logisch wahr (von 
Null verschieden) ist. 

Ausdruck Ein beliebiger Ausdruck, dessen Wert logisch ge¬ 
prüft wird: Er wird in der WHILE-Anweisung ausgewertet. Ist er 
“wahr" (von Null verschieden), werden alle Anweisungen bis zur 
WEND-Anweisung ausgeführt, zu WHILE zurückgesprungen 
und der Ausdruck erneut überprüft. Ist der Ausdruck logisch 
“falsch“ (Null), wird das Programm mit der auf WEND folgenden 
Anweisung fortgesetzt. 

' Dezimal —> Hexadezimal-Uandlung 
ft n t iaci r‘t. $ "J” 

WHILE CUCASE$<nntuiort$) = "J" > 

I NPIJT"Dezima Izahl" ; dez 

PRI NT"Hex—Wert von"dez" ist "HEX$<dez> 

PRI NT’Okt—Wert von"dez" ist "OCT$<dez) 

INPUT"Weiter<JXn)";Bntuort$ 

WEND 

END 

• WHILE . . . WEND-Anweisungen können beliebig geschach¬ 
telt werden. Eine WEND-Anweisung wird vom Interpreter 
immer der letzten vorausgegangenen WHILE-Anweisung 
zugeordnet. 
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• Fehlt eine WHILE-Anweisung zu einer WEND-Anweisung, 
wird die Fehlermeldung 

UENDuithoui WH ILE 

(WEND ohne WHILE) angezeigt. 

• Fehlt eine WEND-Anweisung zu einer WHILE-Anweisung, 
wird die Fehlermeldung 

WHI LE u ithout WEND 

(WHILE ohne WEND) angezeigt. 

• Achtung: Springen Sie niemals in eine WHILE-WEND- 
Struktur, ohne die einführende WHILE-Anweisung ausfüh¬ 
ren zu lassen, da dieses die Programmablaufsteuerung 
von Amiga Basic durcheinanderbringt. 
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WIDTH 


Formate: 

Syntax 1: 
Syntax 2: 
Syntax 3: 

Bedeutung: 


Anweisung 


WIDTH [LPRINT] [Breite] [,Druckzone] 

Wl DTH#Oate/7ir [, Breite] [, Druckzone] 

WIDTH Gerät [, Breite] [,Druckzone] 

Es wird die Druckzeilenbreite für die Ausgabe an eine Ausgabe¬ 
einheit (Drucker, Bildschirm, Datenfernübertragungskanal) in 
Standardzeichen festgelegt. Nach der Ausgabe einer Zeile in der 
mit dieser Anweisung definierten Breite wird ein Wagenrücklauf¬ 
code angefügt. In den Proportional-Zeichensätzen des Amiga 
gilt als Standardbreite die Breite einer beliebigen Ziffer zwischen 
0 und 9. Die voreingestellte Breite für den Bildschirm ist 255. 

Breite Ein ganzzahliger Ausdruck, dessen Wert zwischen 0 und 
255 liegen muß. Eine Breite von Null wird als 1 interpretiert. 

Druckzone Ein ganzzahliger Ausdruck, der die Breite der 
Druckzonen festlegt. Amiga Basic stellt die Druckzonenbreite 
mit 15 ein, wenn nichts anderes angegeben wird. Druckzonen 
entsprechen Tabulatorstops und werden durch ein Komma als 
Trennzeichen in einer PRINT- oder LPRINT-Anweisung ange¬ 
sprungen. 

Dateinr Ein ganzzahliger Ausdruck, der die Nummer der Datei 
spezifiziert, die für ein Ausgabegerät eröffnet wurde. 

Gerät Ein Zeichenkettenausdruck, der das Ausgabegrät spezi¬ 
fiziert. Folgende Geräte können angegeben werden: 

SCRN: Bildschirm 

LPT1: Drucker 

COM1: Datenfernübertragungsanschluß 
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Beispiel: 


Anmerkungen: 


Je nach Ausgabegerät kann eine der oben angegebene Schreib¬ 
weisen für die WIDTH-Anweisung verwendet werden: 

Syntax 1: Wird der Zusatz LPRINT bei der WIDTH-Anweisung 
weggelassen, so wird die Zeilenbreite für Bildschirmausgabe 
gesetzt. Bei gewähltem Proportionalzeichensatz können die 
Zeilenlängen allerdings unterschiedlich sein, weil die Zeichen 
unterschiedlich breit sind. 

Syntax 2: Wird eine Dateinummer angegeben, so wird die 
Ausgabebreite für diese Datei sofort neu gesetzt, wenn sie 
eröffnet ist. 

Syntax 3: Wird ein Gerät angegeben, so wird die neue Ausgabe¬ 
breite zunächst gespeichert und wird erst wirksam, wenn für die 
spezifizierte Einheit eine Datei mit OPEN eröffnet wird. Die neue 
Breite bleibt solange wirksam, wie die Datei eröffnet ist. Ist die 
Datei bereits vorher eröffnet worden, ändert sich die Ausgabe¬ 
breite nicht. Die Anweisungen LPRINT, LLIST und LIST,“LPT1:“ 
benötigen kein OPEN und werden deshalb von dieser Anwei¬ 
sung nicht beeinflußt. 

WIDTH "LPT1:",60 

OPEN "LPT1:” FOR OUTPUT OS 3 


WIDTH#3,80 

Für den Drucker LPT1: wird eine Druckbreite von 60 Zeichen 
definiert, die durch die OPEN-Anweisung aktiviert und später auf 
80 Zeichen geändert wird. 

• Parameterangaben außerhalb der definierten Bereiche erge¬ 
ben die Fehlermeldung 


Illegal Function call 

(unerlaubter Funktionsaufruf). 

• Auf die Tastatur (KYBD:) hat die WIDTH-Anweisung keinen 
Einfluß. 
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• Für den Drucker hat der Interpreter eine Breite von 80 
Zeichen voreingestellt. 

• Bei der Änderung der Ausgabebreite für Drucker sind die 
physikalischen Gegebenheiten des angeschlossenen Druk- 
kers (max. Druckbreite, engere Schrift etc.) zu berücksichti¬ 
gen. 

• Eine Breite von 255 löst die Zeilenstruktur auf. Dieser Wert ist 
für die Datenfernübertragung und Bildschirm (COM1: und 
SCRN:) voreingestellt. 

• Eine Änderung der Ausgabebreite bei Datenfernübertra¬ 
gungsdateien ändert nicht die Pufferlängen. 

• Nach dem Senden der angegebenen Zahl von Zeichen wird 
ein Wagenrücklaufcode übertragen. 

• Siehe auch POS- und LPOS-Funktionen sowie PRINT- und 
LPRINT-Anweisungen. 
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WINDOW-Anweisung 


Formate: 


Syntax 1: WINDOW Kennung [,[Tltel\ [,[(x1,y1)-(x2,y2 )] [,[Typ] [.Sc/j/rm]]]] 

Syntax 2: WINDOW OUTPUT Kennung 

Syntax 3: WINDOW CLOSE Kennung 


Bedeutung: Ein Ausgabefenster wird definiert, aktualisiert oder geschlossen. 

Syntax 1: Diese Syntax bewirkt zweierlei: 

• Es wird ein neues Ausgabefenster erzeugt und im Vorder- 
gund des Bildschirmes angezeigt. 

• Das neue Fenster wird aktiviert und aktualisiert. D.H., nach¬ 
folgende Anweisungen wie PRINT, CIRCLE, LINE, PUT, GET, 
PSET usw. wirken auf dieses Fenster. 

Syntax 2: Das bezeichnete Fenster wird aktiviert und aktuali¬ 
siert, nicht aber in den Bildschirmvordergund gebracht. Grafi¬ 
sche Anweisungen können so im Hintergrund wirken. 

Syntax 3: Das bezeichnete Fenster wird vom Bildschirm ge¬ 
löscht. Wird das aktuelle Fenster gelöscht, so wird das davor 
zuletzt aktualisierte Fenster zum aktuellen Fenster. 

Kennung Ein numerischer Ausdruck, dessen ganzzahliger Wert 
größer als 0 sein muß, und der bei mehreren Fenstern das 
gewünschte Fenster bezeichnet. Amiga Basic weist seinem 
Ausgabefenster beim Start die Kennung 1 zu, so daß Sie für neue 
Fenster eine Kennung von 2 oder größer verwenden sollten. 

Titel Ein Zeichenkettenausdruck, dessen Wert als Titel verwen¬ 
det wird, und der in der Titel-Leiste des Fensters angezeigt wird. 
Im Amiga Basic-Ausgabefenster (WINDOW 1) wird entweder 
BASIC angezeigt oder der Name des aktuellen Programms. 
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Typ Ein numerischer Ausdruck, dessen ganzzahliger Wert die 
Art und Weise festlegt, mit der das Fenster mit Hilfe der Maus 
manipuliert werden kann. Typ kann einer der folgenden Werte 
oder eine Summe aus diesen sein: 

Wert Bedeutung 

1 Die Fenstergröße kann durch Ziehen des Größensym¬ 
bols in der rechten unteren Fensterrand-Ecke mit der 
Maus verändert werden. 

2 Das Fenster kann durch Ziehen der Titel-Leiste mit der 
Maus verschoben werden. 

4 Das Fenster kann durch Wählen des Hintergrund- oder 
Vordergrund-Symbols in der rechten oberen Fenster¬ 
rahmen-Ecke mit Hilfe der Maus in den Hintergrund oder 
Vordergund des aktuellen Bildschirms gestellt werden. 

Wert Bedeutung 

8 Das Fenster kann durch Wählen des Schließ-Symbols in 
der linken oberen Ecke des Fensterrahmens mit der 
Maus geschlossen werden. 

16 Der Fensterinhalt wird wieder angezeigt, wenn das Fen¬ 
ster zwischenzeitlich von einem anderen Fenster überla¬ 
gert wurde. Amiga Basic reserviert ausreichend Spei¬ 
cher. um den Fensterinhalt zwischenzuspeichern. 

Mehrere der angegebenen Funktionen erlauben Sie, indem Sie 
die zugehörigen Werte addieren. Ein Wert von 3 erlaubt z.B. 
durch Ziehen des Größensymbols oder der Titelleiste eine Ver¬ 
größerung oder Verkleinerung sowie die Verschiebung des 
Fensters auf dem Bildschirm. Jeder ganzzahlige Wert zwischen 0 
und 31 ist erlaubt. 

Achtung: Wenn Sie für Typ einen Wert von 17 (1 und 16) 
angeben, reserviert Amiga Basic ausreichend Speicher, um ein 
Fenster in der Größe des gesamten Bildschirmes zu speichern. 
In allen anderen Fällen wird nur für die angegebene Fenstergröße 
benötigte Speichergröße reserviert. Ein Typ-Wert von 17 ver¬ 
braucht also einen sehr großen Speicherbereich. Bei Speicher- 
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Beispiel: 


kritischen Programmen sollten Sie also diese Typ-Wertekombi- 
nation vermeiden. 

xl.yl Die zum aktuellen Bildschirm relativen grafischen Koordi¬ 
naten der linken oberen Ecke des Fensters. 

x2,y2 Die zum aktuellen Bildschirm relativen grafischen Koordi¬ 
naten der rechten unteren Ecke des Fensters. 

Wenn keine Koordinaten angegeben werden, erscheint das 
Fenster an den für dieses voreingestellten Koordinaten. Die 
Ausgangs-Voreinstellungen sind die Koordinaten für den ge¬ 
samten Bildschirm. 

Schirm Ein numerischer Ausdruck, dessen ganzzahliger Wert 
zwischen 1 und 4 liegen muß, und der sich auf die in einer 
vorausgegangenen SCREEN-Anweisung (s. dort) vergebene 
Kennung bezieht. Voreingestellt ist hier ein Wert von 1 (Work- 
bench-Bildschirm). 

WINDOU 1,"Linien",(10,10)-C270,70),IS 
WINDOW 2,"Vielecke”, (310, 10)-(580, 70), 15 
WINDOW 3, "Kpe ise",<10,95> — C270,170) , 15 
WINDOU OUTPUT 1 

Hier überdeckt das Fenster 1 (“Linien“) das Standard-Ausgabe¬ 
fenster von Amiga Basic. 
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WINDOW-Funktion 


Format: v= WINDOW(n) 

Bedeutung: Liefert Informationen über das aktuelle Ausgabefenster. 

n Ein numerischer Ausdruck, dessen ganzzahliger Wert zwi¬ 
schen 0 und 8 liegen muß und der die Art der gefragten 

Information festlegt: 

n übergebene Information 

0 Die Kennung des gewählten Ausgabefensters. Dies ist 
das Fenster, dessen Titel nicht in Geisterschrift ange¬ 
zeigt wird. 

1 Die Kennung des aktuellen Ausgabefensters. Dies ist 
das Fenster, in dem die PRINT- oder die grafischen 
Anweisungen wirken. 

2 Die Breite des aktuellen Ausgabefensters in Bildpunk¬ 
ten. 

3 Die Höhe des aktuellen Ausgabefensters in Bildpunkten. 

4 Die x-Koordinate im aktuellen Ausgabefenster, bei der 
das nächste Zeichen ausgegeben wird. 

5 Die y-Koordinate im aktuellen Ausgabefenster, bei der 
das nächste Zeichen ausgegeben wird. 

6 Die Maximalzahl der für das aktuelle Ausgabefenster 
erlaubten Farben. 

7 Ein Adreßzeiger auf den INTUITION WINDOW-Datensatz 
(s. Amiga Intuition-Handbuch) für das aktuelle Ausgabe¬ 
fenster. 

8 Ein Adreßzeiger auf den RASTPORT- Datensatz (s. 
Amiga Intuition-Handbuch) für das aktuelle Ausgabefen¬ 
ster. 
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Beispiel: Siehe OBJECT.SHAPE-Anweisung. 

Anmerkungen: • Speziell, wenn mit mehreren verschiedenen Fenstern gear¬ 
beitet wird, ist es oft erforderlich, Informationen über ein 
bestimmtes Fenster einzuholen, um auf besondere Situatio¬ 
nen reagieren zu können. Für diesen Zweck ist die WIN- 
DOW-Funktion hilfreich. 
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WRITE 

Format: 

Bedeutung: 


Beispiel: 


■Anweisung 


WRITE [Liste von Ausdr\ 

Die Werte der Ausdrücke in der Liste werden auf dem Bildschirm 
ausgegeben. 

Liste von Ausdr Eine beliebige Liste von numerischen und/ 
oder Zeichenkettenausdrücken, deren Werte auf dem Bildschirm 
angezeigt werden sollen. Die einzelnen Ausdrücke müssen 
durch Komma (,) oder Semikolon (;) voneinander getrennt sein. 
Die Liste muß zusammen mit dem Schlüsselwort WRITE in einer 
Programmzeile stehen. Im Gegensatz zur PRINT-Anweisung (s. 
dort) gibt die WRITE-Anweisung Kommata (,) zwischen den 
einzelnen Werten aus und kleidet Zeichenketten in Anführungs¬ 
striche (“) ein. Vor positiven numerischen Werten wird keine 
Leerstelle ausgegeben. Als Abschluß der Liste von Ausdrücken 
gibt die WRITE-Anweisung einen Wagenrücklauf/Zeilenvor¬ 
schub aus. Eine WRITE-Anweisung ohne Parameter erzeugt 
eine Leerzeile auf dem Bildschirm. 


0=2:B= 3:S$="Ergebnisse: " 
WRITE S$,A + B,fl*B,OfB 

ergibt im Ausgabefenster 

"Ergebnisse: "5,6,B 


Vergleiche auch Beispiel 1 bei der PRINT-Anweisung. 
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WRITE 

Format: 

Bedeutung: 


Beispiel: 


^-Anweisung 


WRITE #Dateinr,Liste von Ausdr 

Die Werte der Ausdrücke in der Liste werden in eine sequentielle 
Datei ausgegeben. 

Dateinr Ein ganzzahliger Ausdruck, dessen Wert die Nummer 
angibt, unter der die sequentielle Ausgabedatei eröffnet wurde. 

Alle weiteren Spezifikationen entsprechen den bei der WRITE- 
Anweisung (s. dort) beschriebenen Die Ausgabe in die sequen¬ 
tielle Datei erfolgt analog zur Ausgabe auf den Bildschirm, so daß 
auch hier auf die WRITE-Anweisung verwiesen werden kann. 

OPEN "DATEI” FOR OUTPUT AS #3 
A$="Hunde-":B$="Kuchen" 

WRITE «3, A$, B$ 

CLOSE 3 

OPEN "DATEI" FOR INPUT AS #3 
INPUT «3, A$, B$ 

PRINT A$; B$ 

ergibt im Ausgabefenster 


Hunde—Kuchen 
Ok 

Die WRITE-Anweisung schreibt das Abbild “Hunde-“,“Kuchen“ 
auf Disk, wodurch bei der INPUT #-Anweisung die beiden 
Elemente getrennt den Variablen A$ und B$ zugewiesen wer¬ 
den. 



Anhang A: ASCII-Zeichencode-Tabellen 

Dieser Anhang enthält die komplette ASCII- und Amiga-Zeichencodetabelle. 
Diese Zeichen können mit der Anweisung 

PRINT CHR$( n) 


0 1 2 3 4 5 6 7 



32 33 34 35 36 37 38 39 

0I1I234567 

48 49 50 51 52 53 54 55 

<? | A|B jC |D E |F |G 

64 65 66 67 68 69 70 71 

P|Q|R|S|T|U|VjM 

80 81 82 83 84 85 86 87 

6 ' [a |b |c id |e |f |ff 

96 97 98 99 100 101 102 103 

7 p k |r |s |t |u |v |w 

112 113 114 115 116 117 118 119 





Zeichencode-Tabellen 


A-1 


auf dem Bildschirm ausgegeben werden. Einige Codes n ergeben dabei kein 
sichtbares Zeichen, sondern haben vielmehr eine optische oder akustische 
Wirkung (Zeilenvorschub, Wagenrücklauf, Bildschirmlöschen, akustisches Signal 
etc.). 


0 


1 


2 


3 


4 


5 


6 


7 


8 9ABCDEF 





-2 


Zeichencode-Tabellen 


0 1 2 3 4 5 6 7 


i i i i i i i i 

144 145 146 147 148 149 150 151 

|i |£ | H |Y|! |§ 

160 161 162 163 164 165 166 167 

°l±FPr luliri- I 

176 177 178 179 180 181 182 183 

192 193 194 195 196 197 198 199 

DFr]^|^!S|D| 

208 209 210 211 212 213 214 215 


I I I I I I I 

224 225 226 227 228 229 230 231 

SftööÖffäD 

240 241 242 243 244 245 246 247 
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8 9ABCDEF 

□ □ □ □ □ □ [□ □ 

136 137 138 139 140 141 142 143 

RI 


I I I I I I I 

152 153 154 155 156 157 158 159 

CSI 


©£ « 




B 


168 169 170 171 172 173 174 175 

, P |2 

184 185 186 187 188 189 190 191 

±±£ü!±i±l±li 


D 


200 201 202 203 204 205 206 207 

0|Ü ü ü ü 

216 217 218 219 220 221 222 223 

£|£|£|e|i i jl [i~ 

232 233 234 235 236 237 238 239 

0 ü ü ix ü S> |f» y 

248 249 250 251 252 253 254 255 
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Anhang B: 

Fehlercodes und Fehlermeldungen 


Während der Abarbeitung eines Programms prüft Amiga Basic vor der Ausführung 
eines Befehls, einer Anweisung, Funktion oder Variablen deren Syntax und ggf. 
auch deren systematische und logische Richtigkeit. Wird ein Fehler gefunden, so 
wird das laufende Programm in der Regel abgebrochen, und eine entsprechende 
Fehlermeldung wird in einem Kommunikationsfenster am oberen Rand des 
Ausgabefensters angezeigt. Der Anwender muß das Ok-Symbolfeld anklicken, 
um die Meldung zu bestätigen. Zusätzlich wird bei sichtbarem List-Fenster die 
fehlerhafte Anweisung durch ein orangefarbenes Rechteck eingerahmt, um die 
Fehlersuche zu erleichtern. 

Programmabbruch und Fehleranzeige können verhindert werden, wenn mit Hilfe 
der ON ERROR-Anweisung sowie den Systemvariablen ERR und ERL (s. dort in 
Kapitel 9) eine systematische Fehlerverarbeitung ins Programm eingebaut wird. 

Amiga Basic unterscheidet zwischen Programmtextfehlern, Disk-Fehlern und 
Fehlern, die vor der Programmausführung angezeigt werden können. In den 
ersten beiden Fällen ordnet Amiga Basic jeder Meldung eine Fehlernummer zu. Im 
Kapitel B.1 sind zunächst die Programmtext- und die Disk-Fehlermeldungen in 
alphabetischer Reihenfolge zusammen mit ihren Fehlercodes aufgelistet. Jeder 
Fehlermeldung ist außerdem eine kurze Beschreibung der möglichen Fehlerursa¬ 
che sowie Hinweise für die Fehlerbeseitigung beigefügt. Alle Fehler, für die kein 
Fehlercode existiert, werden mit der Meldung 

Unprintableerror 

(nicht druckbarer Fehler) angezeigt. 

Im Kapitel B.2 folgen die Fehler, auf die Amiga Basic vor der Programmausführung 
prüft. 


Im Kapitel B.3 sind schließlich alle Fehlermeldungen geordnet nach Fehlercode 
nocheinmal zusammengestellt. 
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Fehlermeldungen 


B.1 Programmtext-Fehlermeldungen 


Code Fehlermeldung 

73 Advanced Feature (Erweiterte BASIC-Eigenschaft) 

Bedeutung: Die verwendete Amiga Basic-Interpreter-Version kann 
eine angegebene Anweisung nicht verarbeiten. 

Abhilfe: Anweisung streichen oder umprogrammieren. 

37 Argument üount m ismatch 

(Argumentanzahl stimmt nicht überein) 

Bedeutung: Die Anzahl der Argumente in einer CALL-Anweisung stimmt 
nicht mit der in der zugehörigen SUB-Anweisung überein. 

54 Bad file mode (Falscher Dateityp) 

Bedeutung: Es wird versucht, eine GET-oder PUT-Anweisung auf eine 
sequentielle oder nicht geöffnete Datei anzuwenden oder eine OPEN- 
Anweisung mit einem anderen als dem I-, 0-, A-oder R-Modus auszu¬ 
führen. 

Abhilfe: OPEN-Anweisung überprüfen. Sicherstellen, daß beim Pro¬ 
gram-Mischen mit dem MERGE-Befehl die dazuzulandende Datei im 
ASCII-Format vorliegt. 

64 Badfilename (Ungültiger Dateiname) 

Bedeutung: In einer FILES-, KILL-, LOAD-, OPEN- oder SAVE-Anwei- 
sung wird ein ungültiger Dateiname verwendet. 

Abhilfe: Dateiname korrigieren, so daß er den in Kapitel 5.2 beschriebe¬ 
nen Regeln genügt. 

52 Bad file number (Falsche Dateinummer) 

Bedeutung: Eine Anweisung oder ein Befehl bezieht sich auf eine Datei 
mit einer Dateinummer, unter der keine Datei eröffnet wurde, oder die 
außerhalb des bei der Initialisierung angegebenen Nummernbereiches 
liegt. 

Abhilfe: Prüfen, ob die betreffende Datei korrekt eröffnet wurde oder ob 
die Dateispezifikation gültig ist. 
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Code Fehlermeldung 

63 Bad record number (Ungültige Satznummer) 

Bedeutung: Es wird versucht, in einer GET- oder PUT-Anweisung für 
Dateien mit wahlfreiem Zugriff eine Satznummer zu verwenden, die 
entweder 0 (Null) oder größer als 16777215 ist. 

Abhilfe: Satznummer in der GET- oder PUT-Anweisung auf einen 
gültigen Wert korrigieren. 

17 Can’tcontinue (Programmfortsetzung nicht möglich) 

Bedeutung: Ein Programm soll mit CONT fortgesetzt werden, das 

• durch eine Fehlermeldung unterbrochen wurde, 

• nach einer Unterbrechung verändert wurde, 

• nicht existiert. 

Abhilfe: Das Programm mit RUN starten oder vorher ggf. noch laden. 

57 Device I/O error (Geräte Ein-/Ausgabefehler) 

Bedeutung: Während einer Ein-/Ausgabeoperation für ein Gerät ist ein 
Fehler aufgetreten, der von AmigaDOS nicht behebbar ist. 

Abhilfe: System rücksetzen und neu starten. 

68 Device unavailable (Gerät nicht verfügbar) 

Bedeutung Es wird versucht, eine Ein-/Ausgabeoperation für ein nicht 
angeschlossenes Gerät oder ein abgeschaltetes Gerät auszuführen. 
Abhilfe: Gerät anschließen und Gerätezustand überprüfen oder nach 
Rückkehr zum Arbeitstisch (Workbench) Amiga Basic wieder aufrufen. 

61 Disk full (Diskette oder Festplatte voll) 

Bedeutung: Es steht kein Speicherplatz für weitere Daten auf der 
Diskette oder Festplatte im aktuellen Laufwerk mehr zur Verfügung. In 
diesem Fall werden alle geöffneten Dateien geschlossen. 

Abhilfe: Alle nicht mehr benötigten Dateien löschen oder eine neue, 
formatierte Diskette verwenden. 

11 Division hy zero (Division durch Null) 

Bedeutung: In einem mathematischen Ausdruck wird versucht, durch 
Null zu dividieren, oder das Ergebnis Null soll mit einer negativen Zahl 
potenziert werden. Das Ergebnis einer solchen Division ist entweder die 
größtmögliche darstellbare Zahl mit dem Vorzeichen der Zahl, die 
dividiert werden sollte, also des Dividenden, oder die positive größtmög¬ 
liche darstellbare Zahl als Ergebnis einer Potenzierung. 

Abhilfe: Die fehlerhafte Division oder Potenzierung korrigieren. 
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Code Fehlermeldung 


10 Dup 1 icate def inition (Doppelte Definition) 

Bedeutung: Es wird versucht, ein und dieselbe Feldvariable mehrmals 
zu dimensionieren. Dies kann folgende Ursachen haben: 

• In zwei oder mehreren DIM-Anweisungen wird derselbe Feldvariab¬ 
lenname verwendet. 

• Ein bereits mit der Standarddimensionierung von 11 Elementen 
dimensioniertes Feld wird noch einmal dimensioniert. 

• Eine OPTION BASE-Anweisung steht nach einer DIM-Anweisung 
oder einer Standarddimensionierung. 

Abhilfe: Programm überprüfen. OPTION BASE-Anweisung ggf. an den 
Programmanfang stellen. 

50 F1ELD overf low (Überlauf bei FIELD-Anweisung) 

Bedeutung: Es wird versucht, in einer FIELD-Anweisung mehr Bytes 
zuzuordnen, als für die Satzlänge für eine Datei mit wahlfreiem Zugriff in 
der zugehörigen OPEN-Anweisung deklariert waren, oder es wurde 
während einer sequentiellen Ein-/Ausgabe mit INPUT #, PRINT # oder 
WRITE # in/von eine(r) Datei mit wahlfreiem Zugriff das Ende des 
FIELD-Puffers erreicht. 

Abhilfe: OPEN- oder FIELD-Anweisung hinsichtlich der Satzlänge auf 
Übereinstimmung prüfen. Bei sequentieller Ein-/Ausgabe von/zu einer 
Datei mit wahlfreiem Zugriff darf die Länge der Daten nicht die für die 
Datei definierte Satzlänge überschreiten. 

58 Fi le already exists (Datei bereits vorhanden) 

Bedeutung: Unter dem bei einem NAME-Befehl ve rwendeten Namen 
existiert schon eine Datei auf der spezifizierten Diskette oder Festplatte. 
Abhilfe: Befehl mit anderem Namen wiederholen. 

55 File already open (Datei bereits geöffnet) 

Bedeutung: Eine bereits zum Schreiben geöffnete sequentielle Datei 
wird erneut zu öffnen versucht oder es wird versucht, eine geöffnete 
Datei zu löschen (mit KILL). 

Abhilfe: OPEN-Anweisungen im Programm überprüfen. Für jede se¬ 
quentielle Ausgabedatei darf nur eine OPEN-Anweisung existieren. 
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Code Fehlermeldung 

53 File not found (Datei nicht gefunden) 

Bedeutung: Eine in den Anweisungen FILES, KILL, LOAD, NAME oder 
OPEN verwendete Datei wird auf der spezifizierten Diskette oder Fest¬ 
platte nicht gefunden. 

Abhilfe: Disk und/oder Dateispezifikation prüfen. 

26 FOR w ithout NEXT (FOR ohne NEXT) 

Bedeutung: Zu einer FOR-Anweisung wird vor dem physischen Pro¬ 
grammende keine zugehörige NEXT-Anweisung gefunden. 

Abhilfe: Das Programm so ändern, daß zu jeder FOR- eine NEXT-An- 
weisung gehört. 

12 1 1 legal direct (unerlaubter Direktmodus) 

Bedeutung: Es wird versucht, eine Anweisung in der Befehlsebene 
(Direktmodus) des Interpreters auszuführen, die nur in der Programme¬ 
bene erlaubt ist (z.B. DEF FN-Anweisung). 

Abhilfe: Die Anweisung darf nur in einem Programm verwendet werden. 

5 11 legal Function ca11 (Unerlaubter Funktionsaufruf) 

Bedeutung: Es wird versucht, einen Parameter außerhalb des gültigen 
Bereiches an eine numerische oder Zeichenketten-Funktion zu überge¬ 
ben. Außerdem kann dieser Fehler in folgenden Fällen angezeigt werden: 

• ein negativer oder zu großer Feldindex; 

• ein ungültiges Argument für eine Funktion oder Anweisung; 

• eine negative Satznummer beim Dateilesen oder -schreiben mit GET 
oder PUT; 

• Versuch, ein geschütztes Amiga Basic-Programm zu listen oder zu 
verändern; 

• Versuch, nichtexistente Zeilennummern zu löschen. 

Abhilfe: Programm korrigieren. Ggf. bei der betreffenden Anweisung 
oder Funktion die Parameterversorgung überprüfen (s.a. Kapitel 9). 
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Code Fehlermeldung 

62 Input past end (Eingabe nach logischem Dateiende) 

Bedeutung: Es wird versucht, eine Eingabeanweisung in einem der 
folgenden Fälle auszuführen: 

• die Datei ist leer; 

• die Datei ist für Ausgabe geöffnet worden; 

• es sind bereits alle Daten aus einer sequentiellen Datei gelesen. 
Abhilfe: EOF-Funktion zum Testen auf Dateiende verwenden, ehe 
gelesen wird. Datei schließen und zum Lesen erneut öffnen. Prüfen, ob 
die Datei überhaupt Daten enthält. 

51 Internal error (Interner Fehler) 

Bedeutung: Bei Amiga Basic diagnostiziert AmigaDOS einen internen 
Fehler. 

Abhilfe: Falls bei erneutem Versuch mit kopiertem Programm dersel¬ 
be Fehler wieder auftritt, muß der Wartungsdienst verständigt werden. 

23 Line buffer overf lou (Zeilenpufferüberlauf) 

Bedeutung: Es wird versucht, eine Zeile mit zuvielen Zeichen (>255) 
einzugeben. 

Abhilfe: Zeile durch Aufteilen in mehrere Zeilen verkürzen. Ggf. Varia¬ 
blen anstelle von Konstanten verwenden. 

22 Missing Operand (Fehlender Operand) 

Bedeutung: Ein Ausdruck (numerisch, logisch oder Zeichenkette) 
enthält einen Operator (z.B. *, AND, +- usw.), dem kein Operand folgt. 
Abhilfe: Ausdruck entsprechend korrigieren. 

1 NEXT Ul ithout FOR (NEXT ohne FOR) 

Bedeutung: Zu einer NEXT-Anweisung existiert keine vorangegangene 
FOR-Anweisung. Es ist auch möglich, daß eine hinter NEXT angegebene 
Variable nicht mit der bei der zugehörigen FOR-Anweisung angegebe¬ 
nen Laufvariablen übereinstimmt. 

Abhilfe: Das Programm so ändern, daß zu jeder NEXT- eine FOR-An¬ 
weisung existiert. 
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Code Fehlermeldung 


19 Mo RESUME 

(Keine RESUME-Anweisung zur Programmfortsetzung) 

Bedeutung: Das Programm ist in eine Fehlerbearbeitungsroutine ver¬ 
zweigt, und der Interpreter findet dort an Stelle einer RESUME-Anwei¬ 
sung, die die Fehlerbearbeitung beendet und das Hauptprogramm 
fortsetzt, nur das physische Ende des Hauptprogramms. 

Abhilfe: Fehlerbearbeitungsroutine überprüfen und RESUME-Anwei¬ 
sung einfügen. 

4 Out of DfiTft (Zu wenig Daten) 

Bedeutung: Eine READ-Anweisung findet keine DATA-Daten. 
Abhilfe: Für ausreichend Daten in DATA-Zeilen sorgen. 

14 Out of heap space (Arbeitsspeicher nicht ausreichend) 

Bedeutung: Der Arbeitsspeicher von Amiga Basic ist übergelaufen 
(z.B. wegen zu vieler geschachtelter Schleifen). 

Abhilfe: Mit der CLEAR-Anweisung (s. dort in Kapitel 9) mehr Stapel¬ 
speicher zuweisen. 

7 Out of mernory (Hauptspeicher nicht ausreichend) 

Bedeutung: Entweder ist das Programm zu groß oder es gibt zu viele 
Variablen oder Dateisteuerblöcke, so daß der Programmspeicher nicht 
ausreicht. 

Abhilfe: Eine CLEAR-Anweisung schafft wieder Platz im Haupt- und 
Stapelspeicher. Ggf. muß auch das Programm verkleinert oder segmen¬ 
tiert werden. 

£» Overf low (Überlauf) 

Bedeutung: Das Ergebnis einer Berechnung oder eine angegebene 
Zahl ist zu groß, um in einem Amiga Basic-Zahlenformat dargestellt 
werden zu können. Bei ganzen Zahlen wird im Überlauffall das Programm 
abgebrochen. Sonst wird die größte bzw. kleinste darstellbare Zahl mit 
dem richtigen Vorzeichen übergeben und nach Ausgabe dieser Meldung 
das Programm fortgesetzt. Es kann also mit einer Fehlerverarbeitungs¬ 
routine nur der Überlauf bei ganzen Zahlen abgefragt werden. 

Abhilfe: Entweder kleinere Zahlen angeben oder Variablen einfacher 
oder doppelter Genauigkeit verwenden. 
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Code Fehlermeldung 


70 Fevinission denied (Schreiben nicht erlaubt) 

Bedeutung: Es wird versucht, auf eine schreibgeschützte Diskette zu 
schreiben. 

Abhilfe: Prüfen, ob die richtige Diskette verwendet wird. Ggf. austau- 
schen oder Schreibschutz ausschalten (s. Amiga-Anwenderhandbuch 
Kapitel 3). 

20 RESUMEuithout error (RESUME ohne Fehlerfall) 

Bedeutung: Während der Programmabarbeitung findet der Interpreter 
eine RESUME-Anweisung, ohne daß ein Fehlerfall vorliegt. 

Abhilfe: Programm korrigieren. Wenn Fehlerbearbeitungsroutinen am 
Ende eines Programms angeordnet sind, fehlt davor möglicherweise 
eine STOP- oder END-Anweisung, so daß eine Fehlerbearbeitungsrouti¬ 
ne ohne Fehlerfall durchlaufen wird. 

3 RETURNuithout GOSUB (RETURN ohne GOSUB) 

Bedeutung: Für eine RETURN-Anweisung (Ende einer Subroutine) 
muß eine GOSUB-Anweisung (Subroutinenaufruf) existieren. 

Abhilfe: Programm korrigieren. Wenn Subroutinen am Ende eines 
Programms angeordnet sind, fehlt davor möglicherweise eine STOP- 
oder END-Anweisung, so daß eine Subroutine ohne Aufruf durchlaufen 
wird. 

16 String fortnula too complex 

Zeichenkettenausdruck zu komplex) 

Bedeutung: Ein Zeichenkettenausdruck ist zu lang oder enthält z.B. 
zuviele geschachtelte Zeichenkettenfunktionen. 

Abhilfe: Den Ausdruck in mehrere einfache Ausdrücke zerlegen. 

15 String too long (Zeichenkette zu lang) 

Bedeutung: Es wird versucht, eine Zeichenkette mit mehr als 255 
Zeichen zu erzeugen. 

Abhilfe: Zeichenkette in mehrere Teilketten zerlegen. 
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Code Fehlermeldung 


36 Subprogram already in use 

(Unterprogramm noch nicht beendet) 

Bedeutung: Es wird ein Amiga Basic-Unterprogramm aufgerufen, das 
bereits vorher aufgerufen, aber noch nicht ordnungsgemäß beendet 
wurde. Rekursive, d.h. sich selbst aufrufende Unterprogramme sind 
nicht erlaubt. 

Abhilfe: Prüfen, ob das betreffende Unterproramm ordnungsgemäß mit 
END SUB oder EXIT SUB beendet wird. 

9 Subscr ipt out of ränge (Index außerhalb des Bereiches) 

Bedeutung: Dieser Fehler kann folgende Ursachen haben: 

• Ein Feldindex wird verwendet, der außerhalb der in der zugehörigen 
DIM-Anweisung festgelegten Grenzen liegt; 

• eine falsche Zahl von Dimensionen wird verwendet; 

• ein Feldindex wird bei einer Variablen benutzt, die kein Feld ist. 
Abhilfe: Entsprechende Feldvariable überprüfen. Möglicherweise wur¬ 
de eine einfache Variable als Feldvariable verwendet oder bei einer 
Basic-Funktion wurde der Name falsch geschrieben. 

2 Syntax error (Syntaxfehler) 

Bedeutung: Der Interpreter findet in einer Programm- oder Anwei¬ 
sungszeile eine unkorrekte Folge von Zeichen (z.B. falsch geschriebener 
Befehl, ungleiche Zahl von rechten und linken Klammern, fehlerhafte 
Interpunktion) oder die Daten in einer DATA-Zeile stimmen im Typ nicht 
mit der Variablen in der READ-Anweisung überein. 

Abhilfe: Die fehlerhafte Zeile muß korrigiert werden. 

67 Too mrtny t i les (Zuviele Dateien) 

Bedeutung: Mit Hilfe von SAVE oder OPEN soll eine neue Datei erstellt 
werden, wenn 

• alle Diskverzeichniseinträge bereits benutzt sind; 

• eine ungültige Dateispezifikation angegeben wurde. 

Abhilfe: Operation mit neu formatierter Diskette wiederholen oder 
Dateispezifikation korrigieren. 
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Fehlermeldungen 


Code Fehlermeldung 


13 Typemismatch (Keine Typübereinstimmung) 

Bedeutung: Es wird versucht, einer Zeichenkettenvariablen einen 
numerischen Wert zuzuordnen oder umgekehrt, oder einer Zeichenket¬ 
tenfunktion wird ein numerisches Argument gegeben oder umgekehrt 
oder es wird versucht, mit der SWAP-Anweisung zwei Variablen unter¬ 
schiedlicher Genauigkeit miteinander zu vertauschen. 

Abhilfe: Programm korrigieren; ggf. Genauigkeit der Variablen überprü¬ 
fen. 

38 Undef ined a.r-r-a.y (Undefiniertes Feld) 

Bedeutung: In einer SHARED-Anweisung wird ein Feld benutzt, das 
noch nicht dimensioniert wurde. 

Abhilfe: DIM-Anweisungen überprüfen und ggf. an den Programman¬ 
fang stellen. 

8 Undef ined labet (Undefinierte Marke) 

Bedeutung: In einer GOTO-, GOSUB-, IF. . THEN-Anweisung oder 
einem DELETE-Befehl ist eine nichtexistente Zeilennummer oder alpha¬ 
numerische Sprungmarke angegeben. 

Abhilfe: Programm prüfen und richtige Zeilennummer oder Sprungmar¬ 
ke einsetzen. 

35 Undef ined subpro^ram (Undefiniertes Unterprogramm) 

Bedeutung: Ein nicht im Programm vorhandenes Unterprogramm wird 
aufgerufen. 

Abhilfe: Unterprogrammnamen überprüfen. Wahrscheinlich ist ein 
Schreibfehler im Namen die Ursache. 

18 Undef ined user fur>ct ion (Undefinierte Anwenderfunktion) 
Bedeutung: Eine Anwenderfunktion wird mit FN aufgerufen, ehe diese 
durch die DEF FN-Anweisung definiert ist. 

Abhilfe: Funktion vorher mit DEF FN definieren. 
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Code Fehlermeldung 

74 Unknoum Uolume (Unbekannte Diskette) 

Bedeutung: Der Begriff ’Volume’ bezieht sich auf den Namen, der beim 
Formatieren einer Diskette vergeben wird (s. Amiga-Anwenderhand- 
buch). Dieser Fehler wird angezeigt, wenn in einer Dateibezeichnung ein 
Disk-Name verwendet wird, der nicht mit dem Namen der eingelegten 
Disk übereinstimmt. 

Abhilfe: Richtige Disk einlegen und Operation wiederholen. 

** Unprintable error (Nichtdruckbarer Fehler; kein Fehlerco¬ 
de!) 

Bedeutung: Für die betreffende Fehlerbedingung existiert keine Feh¬ 
lermeldung. Diese Meldung wird z.B. angezeigt, wenn in einer ERROR- 
Anweisung ein nicht definierter Fehlercode verwendet wird. 

Abhilfe: Prüfen, ob für alle selbstdefinierten Fehlercodes auch Fehler¬ 
routinen existieren. 

30 UIEND uithout WHI LE (WEND ohne WHILE) 

Bedeutung: Zu einer WEND-Anweisung existiert keine vorausgegan¬ 
gene WHILE-Anweisung. 

Abhilfe: Das Programm so ändern, daß zu jeder WEND- eine WHILE- 
Anweisung gehört. 

29 UHILEuithoutUEND (WHILE ohne WEND) 

Bedeutung: Zu einer WHILE-Anweisung wird vor Erreichen des physi¬ 
schen Programmendes keine zugehörige WEND-Anweisung gefunden. 
Abhilfe: Das Programm so ändern, daß zu jeder WHILE- eine WEND- 
Anweisung gehört. 
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Fehlermeldungen 


B.2 Vor der Programmausführung angezeigte Fehler 

Diese Meldungen können angezeigt werden, ehe das Programm gestartet wird, da 
Amiga Basic beim RUN-Befehl zunächst eine formale Überprüfung des Pro¬ 
gramms vornimmt: 


Block ELSE/END IF must, be the f irst statement on tbe 1 ine 

ln einem IF-Block müssen ELSE und END IF am Anfang einer Zeile 
stehen. 


ELSE/ELSE IF/END IFuithout IF 

Zu ELSE, ELSE IF, oder END IF fehlt eine vorausgehende IF-Anweisung. 


EXIT SUB outside oF a subprogram 

EXIT SUB-Anweisung außerhalb eines Unterprogramms. 

FOR w ithout NEXT 

FOR-Anweisung ohne zugehörige NEXT-Anweisung 

IF without END IF 

In einem IF-Block fehlt die END IF-Anweisung. 


Mi ssing STATIC in SUB statement. 

ln SUB-Anweisung fehlt der Zusatz STATIC. 

NEXT uj i thout FOR 

NEXT-Anweisung ohne vorausgehende FOR-Anweisung. 


SHflRED outside of a Subprogram 

SHARED-Anweisung außerhalb eines Unterprogramms. 


Statement illegal uiithin subprogram 

Unerlaubte Anweisung innerhalb eines Unterprogramms. 


SUB a lready defined 

SUB bereits deklariert 

SUB uithout END SUB 

In einem Unterprogramm fehlt die abschließende END SUB-Anweisung 
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Tried t.n decl are SUB u i t. h i n a SUB 

Versuch, SUB innerhalb einer SUB-Anweisung zu deklarieren. 

WHI LE u ithout WEND 

Zu einer WHILE-Anweisung fehlt die WEND-Anweisung. 

WEND w ithout WHI LE 

Zu einer WEND-Anweisung fehlt die vorausgehende WHILE-Anweisung. 


B.3 Nach Fehlercodes geordnete Fehlermeldungen 


Code Fehlermeldung 

1 NEXT without FOR 

2 Syntax error 

3 RETURN without GOSUB 

4 Out of DATA 

5 Illegal function call 

6 Overflow 

7 Out of memory 

8 Undefined label 

9 Subscript out of ränge 

10 Duplicate definition 

11 Division by zero 

12 Illegal direct 

13 Type mismatch 

14 Out of heap space 

15 String too long 

16 String formula too complex 

17 Can’t continue 

18 Undefined user function 

19 No RESUME 

20 RESUME without error 

22 Missing Operand 

23 Line buffer overflow 

26 FOR without NEXT 

29 WHiLE without WEND 

30 WEND without WHILE 

35 Undefined subprogram 
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Fehlermeldungen 

Code 

Fehlermeldung 


36 

Subprogram already in use 


37 

Argument count mismatch 


38 

Undefined array 


50 

FELD overflow 


51 

Internal error 


52 

Bad file number 


53 

File not found 


54 

Bad file mode 


55 

File already open 


57 

Device I/O-Error 


58 

File already exists 


61 

Disk full 


62 

Input past end 


63 

Bad record number 


64 

Bad file name 


67 

Too many files 


68 

Device unavailable 


70 

Permission denied (Disk write protected) 


73 

Advanced feature 


74 

Unknown volume 


* * 

Unprintable error 
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Anhang C: 

Reservierte Amiga Basic-Wörter 


Die im folgenden aufgeführten Wörter sind für Amiga Basic reserviert und dürfen 
nicht als Variablen-, Unterprogramm- oder Sprungmarkennamen verwendet 
werden. Andernfalls wird der Fehler Syntax error SHQGZöiQt. 


ABS 

CVI 

FN 

LOG 

ALL 

CVL 

FOR 

LPOS 

AND 

CVS 

FRE 

LPRINT 

APPEND 

AREA 

DATA 

FUNCTION 

LS ET 

AREAFILL 

DATE$ 

GET 

MENU 

AS 

DECLARE 

GOSUB 

MERGE 

ASC 

DEF 

GOTO 

MID$ 

ATN 

DEFDBL 


MKD$ 


DEFINT 

HEX$ 

MKI$ 

BASE 

DEFLNG 


MKL$ 

BREAK 

DEFSTR 

IMP 

MOD 


DELETE 

INKEY$ 

MOUSE 

CALL 

DIM 

INPUT 


CDBL 


INSTR 

NAME 

CHAIN 

EDIT 

INT 

NEW 

CHDIR 

ELSE 


NEXT 

CHR$ 

ELSE IF 

KILL 

NOT 

CINT 

END 



CIRCLE 

EOF 

LBOUND 

OBJECT.AX 

CLEAR 

EQV 

LEFT$ 

OBJECT.AY 

CLNG 

ERASE 

LEN 

OBJECT.CLIP 

CLOSE 

ERL 

LET 

OBJECT.CLOSE 

CLS 

ERR 

LIBRARY 

OBJECT.HIT 

COLLISION 

ERROR 

LINE 

OBJECT.OFF 

COLOR 

EXIT 

LIST 

OBJECT.ON 

COMMON 

EXP 

LLIST 

OBJECT. PLANES 

CONT 


LOAD 

OBJECT.PRIORITY 

COS 

FIELD 

LOC 

OBJECT.SHAPE 

CSRLIN 

FILES 

LOCATE 

OBJECT.START 

CVD 

FIX 

LOF 

OBJECT.STOP 
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Reservierte Amiga Basic-Wörter (Fortsetzung) 


OBJECT.VX 

POS 

OBJECT.VY 

PRESET 

OBJECT.X 

PRINT 

OBJECT.Y 

PSET 

OCT$ 

OFF 

PUT 

ON 

RANDOMIZE 

OPEN 

READ 

OPTION 

REM 

OR 

RESET 

OUTPUT 

RESTORE 

RESUME 

PAINT 

RETURN 

PALETTE 

RIGHTS 

PATTERN 

RND 

PEEK 

RSET 

PEEKL 

PEEKW 

RUN 

POINT 

SADD 

POKE 

SAVE 

PÖKEL 

SAY 

POKEW 

SCREEN 


SCROLL 

THEN 

SGN 

TIMES 

SHARED 

TIMER 

SIN 

TO 

SLEEP 

TRANSLATES 

SOUND 

TROFF 

SPACES 

SPC 

TRON 

SQR 

UBOUND 

STATIC 

UCASES 

STEP 

USING 

STICK 

STOP 

USR 

STR$ 

VA 

STRIG 

STRINGS 

VARPTR 

SWAP 

WA IT 

SUB 

WAVE 

SYSTEM 

WEND 

WH ILE 

TAB 

WIDTH 

TAN 

WINDOW 

WRITE 


XOR 
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Anhang D: Interne Zahlendarstellung 


Amiga Basic verwendet in seinem mathematischen Teil Binär-Arithmetik. Aus 
diesem Grund unterscheiden sich externe und interne Darstellung von Zahlen. In 
den folgenden Tabellen ist die Angabe der internen Zahlendarstellung hexadezi¬ 
mal. 


D.1 Ganze Zahlen in Amiga Basic 


Ganze Zahlen werden in Amiga Basic intern in vorzeichenbehafteter 16-Bit-Zwei- 
erkomplementdarstellung verwendet: 


Extern 

Intern 

-32768 

8000 

-1 

FFFF 

0 

0000 

1 

0001 

32767 

7FFF 


D.2 Gleitpunktzahlen 


Bei der Binärarithmetik der Gleitpunktzahlen arbeitet Amiga Basic voreinstel¬ 
lungsmäßig mit einfacher Genauigkeit. Dies gilt auch für die Behandlung numeri¬ 
scher Variablen. Berechnungen können aber auch in doppelter Genauigkeit 
durchgeführt werden, benötigen dann aber erheblich mehr Zeit. 


Internes Format bei einfacher Genauigkeit 

32 Bit mit folgender Bedeutung von links nach rechts: 1 Vorzeichenbit 
8 Bit Exponent mit Vorzeichen 
24 Bit Mantisse inklusive führendem 1 er—Bit 

Ist das Vorzeichenbit 0, ist die Zahl positiv, ist es 1, ist die Zahl negativ. 
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Der Exponent ohne Vorzeichen (mit Vorzeichen -7F hex, -127 dez) ist die 
2er-Potenz, mit der die Mantisse multipliziert werden muß. 

Die Mantisse repräsentiert eine Zahl, die größer oder gleich 1 und kleiner als 2 
ist (normalisierte Darstellung). 

Positive Zahlen können bis zu, aber nicht einschließlich einem Wert von 
3.4*10|38 dargestellt werden. 

Die kleinste darstellbare Zahl ist 1.18*10f-38. 

Einfachgenaue Zahlen werden mit bis zu 7.2 Stellen dargestellt. 


Intern 

Extern 

1 

3F800000 

-1 

BF800000 

0 

OOxxxxxx 

10 

41200000 

0.1 

3DCCCCCD 


Internes Format bei doppelter Genauigkeit 

64 Bit mit folgender Bedeutung von links nach rechts: 

1 Vorzeichenbit 

11 Bit Exponent mit Vorzeichen 

53 Bit Mantisse inklusive führendem 1er—Bit 

Ist das Vorzeichenbit 0, ist die Zahl positiv, ist es 1, ist die Zahl negativ. 

Der Exponent ohne Vorzeichen (mit Vorzeichen -3FF hex, -1023 dez) ist die 
2er-Potenz, mit der die Mantisse multipliziert werden muß. 

Die Mantisse repräsentiert eine Zahl, die größer oder gleich 1 und kleiner als 2 
ist (normalisierte Darstellung). 

Positive Zahlen können bis zu, aber nicht einschließlich einem Wert von 
1.79*10|308 dargestellt werden. 


Die kleinste darstellbare Zahl ist 2.23*10f-308. 
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Doppeltgenaue binäre Zahlen werden mit bis zu 15.9 Stellen dargestellt. 


Extern 

Intern 

1 

3FFOOOOOOOOOOOOO 

-1 

BFFOOOOOOOOOOOOO 

0 

OOOxxxxxxxxxxxxx 

10 

4024000000000000 

0.1 

3FB9999999999999 
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Anhang E: 

Umschreibung transzendenter Funktionen 


Einige der trigonometrischen, zyklometrischen und alle Hyperbelfunktionen sind 
nicht Bestandteil des Amiga Basic und müssen daher wie folgt berechnet werden: 


Funktion 


Umschreibung in Amiga Basic 


Logarithmus zur Basis B 
Sekans 
Cosekans 
Cotangens 
Arcussinus 
Arcuscosinus 
Arcussecans 
Arcuscosecans 
Arcuscotangens 
Sinus Hyperbolicus 
Cosinus Hyperbolicus 
Tangens Hyperbolicus 
Cotangens Hyperbolicus 
Sekans Hyperbolicus 
Cosekans Hyperbolicus 
Area Sinus Hyperbolicus 
Area Cos. Hyperbolicus 
Area Tan. Hyperbolicus 
Area Cot. Hyperbolicus 
Area Sec. Hyperbolicus 
Area Cosec. Hyperbolicus 


LOG(X)/LOG(B) 

1/COS(X) 

1/SIN(X) 

1/TAN(X) 

ATN(X/SQR(1-X|2)) 

1.570796-ATN (X/SQR( 1-Xf 2)) 
ATN(SQR(Xf2-1)) + (X<0) *3.141593 

ATN(1/SQR(X|2-1)) 4- (X < 0) *3.141593 

1.57096—ATN(X) 

(EXP(X)-EXP(-X))/2 
(EXP(X) + EXP(—X))/2 
(EXP(X)-EXP(-X)) / (EXP(X) + EXP(-X)) 
(EXP(X) + EXP(-X)) /(EXP(X)-EXP(-X)) 
2/(EXP(X) + EXP(-X)) 

2/(EXP(X)-EXP(-X)) 

LOG(X + SQR(X|2+1)) 

LOG(X + SQR(X|2-1)) 
LOG((1+X)/(1-X))/2 
LOG((X + 1)/(X—1 ))/2 
LOG((SQR(-X|2+ 1) + 1)/X) 
LOG((SGN(X)*SQR(Xf2 + 1)4- 1)/X) 
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Anhang F: 

Format für Maschinensprache-Bibliotheken 


Dieser Anhang beschreibt, wie Amiga Basic aus Namen für Maschinensprache- 
Routinen den Offset in die Sprungleiste für diese Routinen im Speicher ermittelt. 
Diese Informationen sind für den erfahrenen Programmierer gedacht, der sich 
eine Bibliothek von Maschinesprache-Routinen aufbauen will, die von einem 
Amiga Basic-Programm aufgerufen werden können. 

Da die meisten Bibliotheksroutinen in der Assembler-Sprache geschrieben 
werden und ihre Argumente in Registern des Mikroprozessors übergeben be¬ 
kommen, müssen dem Amiga Basic-Programm die Register-Aufrufkonventionen 
für jede Routine bekannt sein. 

Für jede von Amiga Basic mit Hilfe der LIBRARY-Anweisung (s. dort in Kapitel 9) 
aufrufbare Bibliothek muß eine spezielle Disk-Datei existieren, die die oben 
genannten Informationen enthält. Hat die Bibliothek z.B. den Namen 


u :Libs/graphics.1ibrary" 


so erhält die spezielle Datei den Namen 


Libs/graphics.bmap" 


Die Namenserweiterung .bmap besagt, daß es sich hier um eine spezielle Datei 
handelt, für die folgendes Format vereinbar ist: 


Name der Routine: n ASCII-Zeichen, abgeschlossen mit einem O-Byte. 


Sprungleistenoffset: 


Vorzeichenbehaftete 16-Bit-Ganzzahl. 
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Register-Parameter: n Bytes abgeschlossen mit einem O-Byte, deren Wer¬ 

te folgende Bedeutung haben: 

1 = Parameterübergabe in Register DO 

2 = Parameterübergabe in Register Dl 
3= Parameterübergabe in Register D2 
4= Parameterübergabe in Register D3 

5 = Parameterübergabe in Register D4 

6 = Parameterübergabe in Register D5 

7 = Parameterübergabe in Register D6 

8 = Parameterübergabe in Register D7 

9 = Parameterübergabe in Register AO 

10 = Parameterübergabe in Register AI 

11 = Parameterübergabe in Register A2 

12 = Parameterübergabe in Register A3 

13 = Parameterübergabe in Register A4 

Für Routinen, die den Aufrufkonvetionen der Programmiersprache C folgen und 
ihre Parameter auf dem Stapel übergeben bekommen, ist der Registerparameter 
leer, weil Amiga Basic die Registerübergabe hier nicht benötigt. 

Wenn eine Bibliothek z.B. die beiden folgenden Routinen enthält: 

MoveTo(x[D0],y[D1]) mit dem Offset -24 (dezimal) 

ClearRastfpRastPort [AO]) mit dem Offset -30 (dezimal), 

so würde ein hexadezimaler Ausdruck des Inhaltes der .bmap-Datei dieser 
Bibliothek folgendermaßen aussehen: 

4D6F766S546F00FFE8010200436C6S61725261737400FFE20900 

Im Unterverzeichnis “BasicDemos“ auf der Extras-Diskette befindet sich das in 
Amiga Basic geschriebenes Hilfsprogramm ConvertFD, das aus einer gegebenen 
.fd-Datei die zugehörige bmap-Datei erzeugt 
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Anhang G: Ein Beispielprogramm 


Dieser Anhang enthält eine detaillierte Beschreibung des Beispielprogramms 
Picture, mit dem im Kapitel 2.1 die praktische Arbeit mit Amiga Basic beschrie¬ 
ben wurde. Die in eckigen Klammern den Zeilen vorangestellten Buchstaben 
dienen hier nur der Referenz für die Beschreibung der einzelnen Programmzeilen. 
Sie sind nicht Betandteil des Beispielprogramms. 


[A] 

[B] 

[C] 

[D] 

[E] 
[E] 

[G] 

[H] 

[I] 

[J] 

[K] 

[L] 

[M] 

[N] 

[O] 

[P] 

[Q] 

[R] 
[s] 


DEFINT P-Z 
DIM PC 2500) 

CLS 

LI NEC 0,0) —C129,120),,BF 
ftSPECT = . 1 

UHILE flSPECT<20 

CIRCLEC60,60),55,0,, , RSPECT 
RSPECT = RSPECT* 1.4 

WEND 

GET (0,0)-C127,127),P 

CheckMouse: 

I F riOUSEC 0) = 0 THEN CheckMouse 
I F RBSC X-MOUSEC 1) ) > 2 THEN MovePicture 
I F RBSC Y—MOUSEC 2 ) ) < 3 THEN CheckMouse 
MovePicture: 

PUT ( X, Y ) , P 

X=MOUSE(1)Y=MOUSE(2) 

PUTC X,Y ) ,P 
GOTO CheckMouse 
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Hier jetzt die Beschreibung der einzelnen Programmzeilen: 

[A] Amiga Basic behandelt im folgenden alle Variablen, deren Namen mit den 
Buchstaben P bis Z beginnen, als Ganzzahlvariablen. 

[B] Ein Feld mit einer Dimension und 2501 Elementen (0 bis 2500) wird 
angelegt. 

[C] Das Ausgabefenster wird gelöscht. 

[D] Ein Rechteck mit den Koordinaten (0,0) und (120,120) der linken oberen 
bzw. rechten unteren Ecke wird gezeichnet und in der voreingestellten 
Vordergrundfarbe (weiß) ausgemalt. 

[E] Die Variable ASPECT für das Bildverhältnis wird auf den Wert 0.1 gesetzt. 

[F] Die Anweisungen in den Zeilen [G] und [H] werden solange wiederholt 
ausgeführt, wie der Wert von ASPECT kleiner als 20 bleibt. 

[G] Eine Ellipse mit dem Mittelpunkt bei (60,60) und einem Radius von 55 wird> 
mit einem Bildverhälnis, dessen Wert gleich der Variablen ASPECT ist, in 
blau (voreingestellte Hintergrundfarbe) gezeichnet. 

[H] Der Wert von ASPECT wird um den Faktor 1.4 vergrößert. 

[I] Die Programmschleife (WHILE. . .WEND) wird verlassen, sobald ASPECT 
größer oder gleich 20 wird. 

[JJ Der definierte Fensterbereich wird als grafische, binäre Information in das 
Ganzzahlfeld P kopiert. 

[K] Definiert den Einsprungpunkt in einen Programmteil mit dem Sprungmar¬ 
kennamen CheckMouse. 

[L] Wartet auf das Drücken der Auswahltaste (linke Taste) der Maus. 

[M] Verzweigt zur Sprungmarke MovePicture:, wenn die Maus mindestens um 
3 Bildpunkte horizontal bewegt wurde. 

[N] Verzweigt zur Sprungmarke CheckMouse:, wenn die Maus mindestens 
um 4 Bildpunkte vertikal bewegt wurde. 
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[O] Definiert den Einsprungpunkt in einen Programmteil mit dem Sprungmar¬ 
kennamen MovePicture. 

[P] Löscht das Bild an seiner alten Position. 

[Q] Setzt die Variablen X und Y auf die neuen Koordinaten der Maus. 

[R] Kopiert das Bild aus dem Ganzzahlfeld P an die neue, durch X und Y 
gegebene Position. 

[S] Verzweigt wieder zur Sprungmarke CheckMouse, wo auf Mausbewegung 
gewartet wird 
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Anhang H: Sprachausgabe mit Amiga Basic 


ln diesem Anhang wird beschrieben, wie Sie Lautzeichenketten erstellen, die Sie 
mit Hilfe der SAY-Anweisung (s. dort in Kapitel 9) in hörbare, verständliche 
Sprache umwandeln können. Dies wird durch den Sprach-Synthetisierer des 
Amiga ermöglicht. Der Sprach-Synthetisierer ist eine elektronische Einrichtung, 
mit der “künstliche“ Computersprache erzeugt und hörbar gemacht werden kann. 

In der gegenwärtigen Version des Amiga wird nur die Ausgabe angloamerikani- 
scher Sprache von Amiga Basic komfortabel unterstützt (TRANSLATE$-Funkti- 
on), obwohl mit einigem Geschick auch andere Sprachen, darunter auch Deutsch, 
hörbar gemacht werden können, allerdings nur mit stark amerikanischem Akzent. 

Aus diesem Grund beschäftigt sich der wesentliche Teil dieses Anhanges mit der 
angloamerikanischen Sprachausgabe über den Sprachsynthetisierer. 

Kapitel H.10 enthält dann jedoch Hinweise, wie deutsche Sprache ausgegeben 
werden kann, sowie die Liste eines Amiga Basic-Programms, das mit Hilfe von 
zwei trickreichen Unterprogrammen Zeichenketten mit deutschem Text so aufbe¬ 
reitet, daß diese mit der SAY-Anweisung als deutsche Sprache ausgegeben 
werden können. 

Um den Sprachsynthetisierer des Amiga nutzen zu können, benötigen Sie weder 
große phonetische oder Computer-Erfahrungen, noch Kenntnisse in einer Fremd¬ 
sprache. Vielmehr benötigen Sie ein gutes Wörterbuch wie z.B. Webster’s Third 
International für Englisch oder den Duden für Deutsch, um im Zweifelsfall die 
richtige Aussprache oder Betonung von Wörtern nachschlagen zu können. Das 
Faszinierende am Schreiben phonetischer Sprache ist, daß Sie nicht die korrekte 
Rechtschreibung eines Wortes, sondern nur seine korrekte Aussprache kennen 
müssen. 

Sie können speziell englische Sprache so niederschreiben, wie Sie sie sprechen 
würden. 
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Der Sprachsynthetisierer bearbeitet sprachliche Ausdrücke auf dem Satz-Niveau. 
Auch wenn Sie nur ein einzelnes Wort ausgeben wollen, wird dieses als kompletter 
Satz aufgefaßt. Aus diesem Grunde erwartet der Synthetisierer am Ende eines 
jeden Satzes entweder einen Punkt (.) oderein Fragezeichen (?). Befindet sich am 
Ende der auszugebenden Zeichenkette keines dieser beiden Zeichen, so fügt der 
Synthetisierer automatisch einen Punkt (.) an. Der Punkt, der bei fast allen 
Sprachausdrücken verwendet wird, resultiert in einem Abfall der Stimmhöhe am 
Satzende. 

Das Fragezeichen, das nur am Ende von Ja-/Nein-Fragen verwendet wird, 
resultiert auch in einem Abfall der Stimmhöhe am Satzende. Die Frage “Do you 
enjoy using your Amiga?“ (Macht Ihnen die Arbeit mit Ihrem Amiga Spaß ?) 
benutzt ein Fragezeichen am Ende, weil die Antwort ja oder nein lautet. Anderer- 
seit sollte die Frage “What is your favorite color“ (Was ist Ihre Lieblingsfarbe) mit 
einem Punkt abgeschlossen werden. Der Synthetisierer unterscheidet noch 
andere Interprunktionsformen, wie später noch beschrieben wird. 


H.1 Phonetisches Buchstabieren 


Ausdrücke werden phonetisch gewöhnlich mit Hilfe eines Ton-Alphabets (Inter¬ 
nationales Phonetisches Alphabet) geschrieben. Dieses phonetische Alphabet 
findet sich im Vorspann jedes besseren Wörterbuches. Da diese Symbole nicht 
leicht auswendig zu lernen sind und auch nicht auf den normalen Computer-Ta¬ 
staturen verfügbar sind, hat die Organisation Advanced Research Projects 
Agency (ARPA) ein spezielles Alphabet, genannt Arpabet, entwickelt, mit dem 
jedes phonetische Symbol durch einen oder zwei Großbuchstaben des lateini¬ 
schen Alphabets dargestellt werden kann. 

Zur Ausgabe phonetischer Töne verwendet der Synthetisierer eine erweiterte 
Version des Arpabets. 
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Ein Laut, auch als Phonem bezeichnet, ist ein sprachlicher Grundton, also die 
kleinste hörbare Spracheinheit. So wird die gesprochene Sprache zunächst in 
Sätze, diese in Wörter, Wörter in Silben und Silben in Phoneme oder Laute 
unterteilt. Beispielsweise besteht das Wort cat (Katze) aus drei Buchstaben und 
geichzeitig auch aus drei Lauten. Wenn Sie jetzt einen Blick auf die Phonem-Ta¬ 
belle im Kapitel H.11 werfen, sehen Sie, daß das Wort cat aus den drei Phonemen 
K, AE und T gebildet und als KAET dargestellt werden kann. Das Wort cent wird 
aus den Phonemen S, EH, N und T zu SEHNT zusammengesetzt. Beachten Sie 
hier, daß, obwohl beide Wörter mit dem Buchstaben c beginnen, im ersteren Fall 
das Phonem K gesetzt wird, da hier das c wie k ausgesprochen wird. Ein 
C-Phonem gibt es nicht; das phonetische Buchstabieren basiert nämlich auf dem 
Konzept: 

Buchstabiere ein Wort, wie es sich ausgesprochen anhört, nicht wie es 
geschrieben wird 


H.2 Wahi des richtigen Vokals 


Wie geschriebene Wörter in Buchstaben zerfallen, zerfallen Phoneme in Vokale 
(Selbstlaute) und Konsonanten (Mitlaute). Ein Vokal ist ein kontinuierlicher Ton, 
der durch Stimmbandvibration bei gleichzeitigem Luftaustritt durch den Mund 
(nicht durch die Nase) gebildet wird. Alle Vokale benutzen für die Phonem-Dar¬ 
stellung einen Zweibuchstaben-Code. Ein Konsonant dagegen ist jeder andere 
Laut, der durch Luft-Zischen (s oder th) oder Luftstromunterbrechungen mit den 
Lippen oder der Zungenspitze (b odert) gebildet wird. Konsonanten benutzen für 
die Phonemdarstellung einen Ein- oder Zweibuchstaben-Code. 

Im Schrift-Englisch werden, wie im Deutschen auch, die fünf Vokale a, e, i, o, und u 
verwendet. Andererseits kommen im gesprochenen Englisch mehr als 15 Vokale 
vor. Der Sprachsynthetisierer des Amiga berücksichtigt die meisten von ihnen. 
Um den richtigen Vokal aus der Phonemtabelle zu wählen, muß man ihn zunächst 
selbst hören. Deshalb sollte man sich das betreffende Wort laut vorsprechen und 
ggf. dabei den gesuchten Vokal dehnend hervorheben. Dann vergleichen Sie den 
von Ihnen gebildeten Ton mit den Vokaltönen in den Beispielen rechts neben den 
Phonem-Codes in der Phonem-Tabelle. So klingt z.B. das a im Wort apple genau 
so, wie das a im Wort cat und nicht etwa so, wie das a in den Wörtern Amiga, tatk 
oder made. Beachten Sie auch, daß einige der Beispielwörter keinen der Buchsta¬ 
ben enthalten, aus denen der zugehörige Phonem-Code gebildet wird, so z.B. der 
Code AA für den Vokal im Wort hot. 
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• Hier ist eine Anmerkung für all die Anwender angebracht, die mit dem 
Sprachsynthetisierer des Amiga deutsche Sprache erzeugen wollen. Bei den 
meisten Phonem-Codes in den Tabellen in Kapitel H.11 sind auch deutsche 
Beispiele angegeben. Bei einigen ist dies jedoch nicht möglich, wie z.B. beim 
th des Englischen. In einer späteren Version des Amiga wird auch der 
Sprachsynthetisierer für deutsche Sprachausgabe vorbereitet werden. 

Vokale fallen in zwei Kategorien: jene, die während ihrer Dauer denselben Ton 
beibehalten und jene, die ihn über die Dauer ändern. Letztere werden auch als 
Doppelvokale (Diphthongs) bezeichnet. Sie errinnern sicher aus Ihrer Schulzeit, 
daß Vokale kurz oder lang klingen können. Doppelvokale klingen lang, sind aber 
darüberhinaus ziemlich komplex. Sprechen Sie sich z.B. das Wort made laut und 
sehr langsam vor. Beachten Sie, daß das a zunächst wie das e im Wort bet beginnt 
aber dann eher wie e in beet endet. Das a ist deshalb in diesem Wort ein 
Doppellaut, dessen Phonem-Code durch EY dargestellt wird. 

Bei anderen Sprachsynthetisierern müssen Sie die Klangänderungen in Doppelvo¬ 
kalen als separate Phoneme angeben. Beim Amiga nimmt ihnen der Sprachsyn¬ 
thetisierer die Zusammensetzung der Klangänderung bei Doppelvokalen ab. 


H.3 Wahl des richtigen Konsonanten 


Phonetiker unterteilen die Konsonanten in mehrere Kategorien, von denen die 
meisten jedoch für unsere Betrachtungen keine Relevanz haben. Um den richti¬ 
gen Konsonanten zu setzen, brauchen Sie nur darauf zu achten, ob er stimmhaft 
oder stimmlos ist. Ein stimmhafter Konsonant wird mit Stimmbandvibration, ein 
stimmloser ohne gebildet. Schrift-Englisch benutzt manchmal dieselbe Buchsta¬ 
benkombination, um beide Fälle darzustellen. Vergleichen Sie z.B. nur den Klang 
von th in den Wörtern thin und then. Beachten Sie, daß der th-Klang in thin durch 
Luftströmung zwischen Zungenspitze und oberen Schneidezähnen gebildet wird; 
bei then schwingen dabei zusätzlich die Stimmbänder mit. Der Phonem-Code für 
das stimmhafte th ist DH, für das stimmlose TH. Phonetisch wird das Wort thin als 
THIHN, das Wort then als DHEHN geschrieben. 
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Zwei Laute, die besonders häufig eine Fehlerquelle in der Sprachverständlichkeit 
darstellen, sind das stimmhafte und das stimmlose s. Die phonetische Codierung 
hierfür ist S bzw Z. Beispielsweise endet das Wort bats mit dem Phonem S 
während suds mit Z endet. Sprechen Sie sich auch hier das Wort laut vor, um 
herauszufinden, ob es sich um ein stimmhaftes oder stimmloses s handelt. 

Eine weitere Fehlerquelle in der Sprachverständlichkeit ist der r-Laut. Das 
Alphabet des Sprachsynthetisierers enthält für r zwei unterschiedliche Phoneme: 
R bei den Konsonanten und ER bei den Vokalen. Wenn der r-Laut der einzige Laut 
in der Silbe ist, verwenden Sie ER. Beispiele hierfür sind die Wörter absurd, 
Computer und flirt. Wenn dagegen der r-Laut einem anderen Vokal vorangestellt 
ist oder folgt, ist R zu verwenden. Beispiele hierfür sind die Wörter car, write oder 
craft. 


H.3 Die Verwendung von Sprachkontraktionen und speziellen Symbolen 


Viele Phonem-Kombinationen in gesprochenen englischen Wörtern enstehen 
durch nachlässige Aussprache. So wird zum Beispiel in dem Wort connector das 
erste o meistens fast vollständig verschluckt, so daß anstelle des AA-Phonem- 
Codes der AX-Code verwendet wird. Da im Sprach-Englischen Vokale häufig 
nachlässig ausgesprochen werden, treten die Phonem-Codes AX und IX wieder¬ 
holt vor I, m oder n auf. 

Der Sprachsynthetisierer stellt für die Eingabe solcher Phonem-Kombinationen 
Abkürzungen zur Verfügung. Statt das Wort personal als PERSIXNAXL zu 
“buchstabieren“, verwendet der Synthetisierer PERSINUL. Das Wort anomaly 
wird UNAAMULIY anstatt AXNAAMAXLIY “buchstabiert“ und das Wort combina- 
tion wird zu KAAMBINEYSHIN anstelle von KAAMBIXNEYSHIXN. Um entscheiden 
zu können, ob man für die Vokal-Vernachlässigung besser AX oder IX verwendet, 
probieren Sie beide aus und entscheiden, welche besser klingt. 

Der Sprachsynthetisierer verwendet außerdem intern spezielle Symbole, die er 
gelegentlich in Ihren eingegebenen Satz einfügt, oder Teile des Satzes durch 
solche Symbole ersetzt. 
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Einige dieser Symbole können Sie direkt eingeben. Das wohl nützlichste ist Q 
(Stimmritzen-Stop), Hier wird die Luftströmung durch die Stimmritze im Kehlkopf 
abrupt unterbrochen. Ein Beispiel ist das Wort Atlantic, bei dem der Stop 
zwischen den Buchstaben t und I liegt. Der Synthetisierer kennt bereits diesen 
Stop, so daß Sie ihn nicht extra anzugeben brauchen. Sie können aber den 
Phonem-Code Q dort einfügen, wo sich das gesprochene Wort dann besser 
anhört. 


H.5 Betonung und Tonfall 


Nachdem Sie jetzt gelernt haben, wie Sie dem Synthetisierer das, was er “sagen“ 
soll, mitteilen müssen, sollen Sie jetzt lernen, ihm mitzuteilen, wie er es sagen soll. 

Betonungszeichen und Tonfall dienen dazu, die Bedeutung eines Satzes zu 
ändern, wichtige Wörter hervorzuheben und die Betonung in mehrsilbigen Wör¬ 
tern auf die richtige Silbe zu legen. Damit wird die Verständlichkeit und Natürlich¬ 
keit der synthetischen Sprachausgabe weiter verbessert. 

In den Phonem-Codeketten werden Betonungszeichen als einzelne Ziffern zwi¬ 
schen 1 und 9, denen ein Vokal-Phonem-Code folgt, angegeben. Obwohl 
Betonung und Tonfall nicht dasselbe sind, werden beide durch eine einzelne Zahl 
definiert. Neben anderen Wirkungen ist die Betonung die Verlängerung einer 
Silbe. Die Betonung ist also ein logischer Term: die Silbe wird betont oder nicht. 
Zur Kennzeichnung einer zu betonenden Silbe wird eine Zahl dem Vokal in der 
Silbe angefügt. Die Existenz dieser Zahl (nicht ihr Wert) weist den Synthetisierer 
an, diese Silbe zu betonen. Der Tonfall dagegen wird durch den Wert der Zahl 
definiert. Unter Tonfall wird hier das Stimmhöhenmuster oder die Kontur eines 
Ausdruckes verstanden. 

Je größer der Wert der Betonungsziffer ist, um so höher liegt das Stimmhöhenpo¬ 
tential für den Akzent. Der Tonverlauf eines jeden Satzes besteht in einer rasch 
ansteigenden Tonhöhe bis zur ersten betonten Silbe im Satz, gefolgt von einer 
langsam abklingenden Tonhöhe durch den weiteren Satzverlauf bis zu einem 
raschen Abfall zur niedrigsten Tonhöhe bei der letzten Silbe. Weitere betonte 
Silben bewirken eine Unterbrechung im langsamen Abfall der Tonhöhe während 
des Satzverlaufes durch raschere Anstiege und Abfälle der Tonhöhe im Bereich 
jeder betonten Silbe. Der Synthetisierer arbeitet mit einer komplexen Prozedur, 
um einen möglichst natürlichen Tonhöhenverlauf entsprechend der von Ihnen 
gesetzten Betonungszeichen nachzubilden. 
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H.6 Die Verwendung von Betonungszeichen 


Betonungszeichen werden direkt hinter den Vokal-Phonem-Codes angegeben. 
Beispielsweise gehört das Betonungszeichen im Wort cat hinter den Phonem-Co¬ 
de AE, also KAE5T. Im Allgemeinen gibt es für den Platz der Zahl in der 
Phonem-Code-Kette keine Alternative. Entweder folgt dem Vokal ein Betonungs¬ 
zeichen oder nicht. Der Synthetisierer prüft nicht auf richtig gesetzte Betonungs¬ 
zeichen bei Vokalen. Er zeigt nur einen Fehler an, wenn ein Betonungszeichen auf 
einen Konsonaten folgt. Für das Setzen von Betonungszeichen halten Sie sich an 
folgende Regeln: 

1. Setzen Sie Betonungszeichen innerhalb von Wörtern, die eine besondere 
Bedeutung haben (Bedeutungs-Wörter). Solche Wörter sind Nomen (Haupt¬ 
wörter), Verben (Tätigkeitswörter) und Adjektive (Eigenschaftswörter). Wör¬ 
ter wie tonsiis, remove und huge sind Beispiele, bei denen einem Zuhörer 
mitgeteilt wird, worüber gesprochen wird Andererseits haben Wörter wie but, 
if, is und the keine besondere Bedeutung und werden deshalb als Funktions- 
Wörter bezeichnet. 

2. Setzen Sie immer ein Betonungszeichen auf die zu betonende(n) Silbe(n) von 
mehrsilbigen Wörtern, gleichgültig ob es sich dabei um Bedeutungs- oder 
Funktions-Wörter handelt. Beim Wort Commodore liegt die Betonung auf der 
ersten Silbe. In Phonem-Codes ausgedrückt heißt dies: KAA5MAXDOHR. 
Das Wort Computer wird auf der zweiten Silbe betont, also KUMPYUW5TER. 
Wenn Sie bei der Betonung eines Wortes im Zeifel sind, sehen Sie im 
Wörterbuch nach. 

3. Werden in einem mehrsilbigen Wort mehr als eine Silbe betont, werden die 
Sekundärbetonungen nur mit einem Zahlenwert von 1 oder 2 markiert. Beim 
Wort understand werden beispielsweise die erste und letzte Silbe betont, und 
zwar die Silbe stand primär und die Silbe under sekundär; in Phonem-Codes 
also: AH1NDERSTAE4ND. 

4. Zusammegesetzte Wörter wie baseball oder Software werden als ein Wort 
geschrieben, aber wie zwei Wörter behandelt, wenn Betonungszeichen ge¬ 
setzt werden. So wird also das Wort lunchwagon in Phonemen als LAH5NCH- 
WAE2GIN “buchstabiert“. Beachten Sie daß die stärkere Betonung auf dem 
Wort lunch liegt, da in zusammengesetzten Wörtern immer das erste Wort am 
stärksten betont wird. 
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H.7 Setzen von Betonungswerten 


Nachdem Sie die korrekte Aussprache und die richtige Plazierung von Betonungs¬ 
zeichen festgelegt haben, müssen Sie sich noch für den Betonungwert, also den 
Tonfall, für eine zu betonende Silbe entscheiden. Die einzelnen Bestandteile der 
englischen Schriftsprache werden nach folgender Tabelle mit unterschiedlichen 
Betonungswerten versehen: 


Sprachelement 


Betonungswert 


Nomen (Hauptwörter) 5 

Pronomen (Fürwörter) 3 

Verben (Tätigkeitswörter) 4 

Adjektive (Eigenschaftswörter) 5 

Adverben (Ergänzungswörter) 7 

Bestimmungswörter 7 

Ausrufe 9 

Artikel 0 ohne Beton. 

Präpositionen (Verhältniswörter) 0 

Konjunktionen (Verbindungswörter) 0 

Sekundärbetonung 1, geleg. 2 


Die Werte in dieser Tabelle sind nur als Vorschlag zu verstehen. Sie können in 
besonderen Fällen natürlich diese Werte auch erhöhen oder erniedrigen, ganz wie 
es die individuellen Anwendungen verlangen. 


H.8 Setzen von Satzzeichen (Interpunktion) 


Zusätzlich zu den beiden bereits erwähnten Satzendezeichen Punkt (.) und 
Fragezeichen (?) kennt der Synthetisierer noch den Gedankenstrich (-), das 
Komma (,) und die runden Klammern (). Das Komma wird dort gesetzt, wo es auch 
im Schrift-Englischen gesetzt würde und veranlaßt den Synthetisierer zu einer 
kleinen Pause mit leichtem Anstieg in der Stimmhöhe, um anzuzeigen, daß noch 
mehr folgt. Sie können aber auch mehr Kommata als in dem entsprechenden 
geschriebenen Satz setzen, um einzelne Satzteile akustisch noch deutlicher zu 
trennen. 
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Der Gedankenstrich hat dieselbe Wirkung wie das Komma, jedoch mit dem 
Unterschied, daß die Stimmhöhe nicht so deutlich angehoben wird. Sie kommen 
wahrscheinlich mit folgender Faustregel am besten zurecht: 

Trennen Sie Ausdrücke mit Gedankenstrichen und Nebensätze mit Kommata. 

Klammern haben eine besondere Bedeutung für die Betonungssteuerung des 
Synthetisierers. Klammern Sie Ausdrücke, bestehend aus zwei oder mehreren 
Bedeutungs-Wörtern wie z.B. giant yacht. Besonders effektiv können Klammern 
bei großen Ausdrücken wie the silliest guy I ever saw sein. Sie ermöglichen einen 
annähernd natürlichen Sprachhöhenverlauf. 


H.9 Verbesserung der Sprachverständlichkeit 


Obwohl Ihnen diese Einführung in die Sprachsynthetisierung einen möglichst 
reibungslosen Start in die eigene Arbeit mit diesem neuen Medium erlauben soll, 
bleibt doch der einzig sichere Weg zur Professionalität die Praxis. Folgen Sie 
deshalb den hier beschriebenen Tricks, um die Sprachverständlichkeit eines 
computer-gesprochenen Satzes zu verbessern. 

1. Mehrsilbige Wörter sind häufig besser verständlich als einsilbige. Sagen Sie 
lieber enormous anstelle von huge. Das längere Wort enthält in allen-Silben 
Informationen, so daß der Zuhörer mehrmals die Gelegenheit bekommt, das 
Wort richtig zu verstehen. 

2. Optimieren Sie die Satzlänge. Orientieren Sie sich beim Schreiben für den 
Synthetisierer eher am gesprochenen als am gelesenen Text. Schreiben Sie 
keine Sätze, die nicht in einem Atemzug gesprochen werden können. Redu¬ 
zieren Sie den Satzgehalt auf eine Idee. 

3. Betonen Sie neue Begriffe deutlich, wenn Sie das erstemal gehört werden. 
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H.10 Umsetzung deutscher Schriftsprache 


Mit den vorhandenen Phonem-Codes läßt sich englischer, genauer angloamerika- 
nischer, Text in befriedigender Qualität wiedergeben. Die TRANSLATE$-Funktion 
nimmt dem Programmierer dabei die Auswahl der richtigen Phonem-Codes ab. 

Um deutschsprachigen Text wiederzugeben, ist zweierlei nötig: 

• eine Routine ähnlich der TRANSLATE$-Funktion, die Klartext in Phonem-Co- 
de-Zeichenketten umsetzt; 

• ein Satz zusätzlicher Phonem-Codes, die die im Angloamerikanischen nicht 
vorhandenen Laute ergänzt. 

Der zweite Punkt befindet sich gegenwärtig noch in Arbeit. Das erste Problem läßt 
sich jedoch mit relativ geringem Aufwand lösen. 

Das im folgenden abgedruckte Programm enthält zwei Routinen, die zusammen 
die TRANSLATE$-Funktion für die Synthetisierung deutscher Sprache ersetzen. 

Mit dem Subroutinenaufruf 

GOSUB initdeutsch 

(s. Programmliste) wird der Aufruf des eigentlichen Unterprogramms vorbereitet. 
Die Wandlung einer Textzeichenkette text$, die deutschen Text enthält, in eine 
Phonem-Code-Zeichenkette deutsch$ erfolgt durch den Unterprogrammaufruf 


germantext$,deutsch$ 


Die Zeichenkette deutsch$ kann dann mit Hilfe der SAY-Anweisung in verständli¬ 
che Sprache umgewandelt werden. 

In dem hier abgedruckten Beispiel liest das Demonstrationsprogramm den Text 
aus einer Diskettendatei test.txt und übergibt ihn aufbereitet der SAY-Anwei¬ 
sung. 
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Die beiden Routinen sind sicherlich noch nicht vollkommen. So werden z.B. 
keinerlei Betonungen gesetzt, wie das bei derTRANSLATE$-Funktion der Fall ist. 
Außerdem sind auch die Umlaute noch nicht implementiert. Diese müssen noch 
ausgeschrieben werden. Eine weitere Schwierigkeit besteht darin, daß im deut¬ 
schen Text nicht immer feststellbar ist, wann ein Vokal kurz oder lang gesprochen 
werden soll. Im vorliegenden Beispiel wird er im Zweifel kurz gesprochen. Deshalb 
muß man in Einzelfällen durch gezielt falsche Schreibweise des Textes zur 
Verbesserung der Sprachverständlichkeit etwas nachhelfen. Beispiele hierfür sind 
Commodohre oder Paries. 
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* Beispiel fuer Anwendungen der SAY-Anweisungen 
’ zur deutschen Sprachausgabe : 

J Sprechen des Textes aus der Daite i test. txt 

GOSLIB in itdeutsch 
OPEN "IM, "test.txt" 

WHILENOTEOF(i) 

LI NE INPUT #1,text$ 

german text$, deutsch$ ' Aufruf der Subroutine german 
SflY deutsch$, howS? 

WEND 
CLOSE 1 
SVSTEM 
END 

’ Ende des Beispielprogramms 
’ Beginn der Subroutinen 

in itdeutsch : * Deutschen Text sprechen 
nn= 0:ni = 0:RESTORE phoneme:a$ = ":" 

UHILE a$<>"end" 

READ » Kl 
IF n>0 THEN 
an-fiSC(a$) 

I F an> nn THEN nn-an 
IF n>ni THEN ni = n 
FOR i=lTOn 
READ b$,c$ 

NEXT 
END IF 


WEND 
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DIM te$(nn«ni),ph$(nn,ni) t nt%(nn) 
RESTORE phoneme : a$=" : ” 

WHILE a$<> ,, end" 

READ a$, n 

IF n>0 THEN 

an=ASC(a$)-ntX(an)=n 
FOR i=lTO n 

READ ie$(an, i)j ph$( aiij i) 
NEXT 
END IF 
UEND 

RESTORE phonemparam 
FOR j = 0 TO 8 

READ howX(j) 

NEXT 


i r» itend : 

RETURN 


subger' 

SUB geman Ct$,d$) STATIC 
SHARED te$( ), ph$C ),nt*( » 
nn=UBOUND(te$ f 1) 
s$='”’:t$=UCASE$<*$) 
t$="" 

FOR i=lTO LEN(t$) 

a=ASC(t1ID$(t$.i.l)) 

IF a>nn THEN nexti 
IF nt«(a) THEN 

FOR j=lTO nU(a) 

I F MID$(t$j i,LEN(te$(a,j))) = te$(a,j) THEN 

s$-s$+ph$ ( a, j ) : i = i + LEN(-te$( a, j)) —l:j=n-t3£(a) 
END IF 
NEXT j 
END IF 

next i : 

NEXT i 
d$=s$ 

END SUB 
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phoneme: * Phonem—Codes fuer deutsche Sprache 

DATA ” ”, 1,” " 

DATA A,8,PEU,OY,flEH,ftEPE,PY,PY,ftI,flY,ftH,PAAA,AU,AW,ftE 
DATA Bj 1,B,B 

DATA C, 8, CPE,TSAE, ” CH"/’ K”, CHS, KS, CH, /C, CK, K 
DATA CE, TS EH ,CI,TSIH,C,K 
DATA D, 1, D, D 

DATA E, 10,”EN ","IXN ”, ”EL ”,”1XL "/'ER "/’IXR ”,”ES ","IXS ” 

DATA EI,AY, EY,AY,EH,EH,EU,OY,EN,EHN, E, EH 

DATA F, 1, F, F 

DATA G, 1, G,G 

DATA H, l f H,/H 

DATA I , 6, °IR ”, ”IYR ”, I P, IYPA, 10, IYOH, 1E,IY,IH,IY,I,IX 

DATA J , 2 , ” J” , ” I HY” , J , Y 

DATA K, 1, K, K 

DATA L, 1, Lj L 

DATA M, 1,11,11 

DATA N,IjNjN 

DATA 0,6,OEH,ER,OE,ER,OU,UH,Ol,OY,OH,OH,O,OH 

DATA P, 2, PH, F, P, P 

DATA Q, 1, Q, KO 

DATA R, 1, R, R: REM oder RX 

DATA S, 22, SCH, SH, ”ST ”,”ST ", SB, SB, SD, SD, SF, SF, SG, SG, SH, S^H 

DATA SJ,SY,SK,SK,SL,SL,SM,SM,SN,SN,SP,SHP,SQ,SKO 

DATA SR,SR,SS,S,ST,SHT,SO,SF,SW,SO,SX,SKS,SZ,STS,S,Z 

DATA T,6,TIO,TSIYOH,TIA,TSIYAA,TZ,TS,TH,TT,TT,TT,T,DT 

DATA U, 5, UEH, ER, UE,ER,UH, UW,”U ”, "UW ”, U, UH 

DATA U, 1,0, F 

DATA W, 1,U,U 

DATA X, 1, X, KS 

DATA Y,2,YH, IH, Y, IH 

DATA Z, 1, Z,TS 

DATA end, 0 


phonemparam: 


DATA 65,0,120,0,22200,64, 10,0,0 
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H.11 Phonem-Code-Tabellen 

In den folgenden Phonem-Code-Tabellen ist überall da, wo es möglich ist, auch 
ein deutsches Wort als Beispiel eingefügt. 


Vokale 

(Selbstlaute) 





Code 

Beispiele 


Code 

Beispiele 



englisch 

deutsch 


englisch 

deutsch 

IY 

beet 

Lied 

IH 

bit 

Kitt 

EH 

bet 

Bett 

AE 

bat 

Säcke 

AA 

hot 

Rotte 

AH 

under 

Expander 

AO 

talk 

Wort 

UH 

look 

Glucke 

ER 

bird 

Mörder 

OH 

border 

Ordner 

AX 

about 


IX 

solid 

bitter 

AX und 

IX sollten niemals in betonten Silben verwendet werden. 


Doppel-Vokale (Doppel-Selbstlaute) 


Code 

Beispiele 


Code 

Beispiele 



englisch 

deutsch 


englisch 

deutsch 

EY 

made 


AY 

hide 

beide 

OY 

boil 

Reuse 

AW 

power 

Bauer 

OW 

low 


UW 

crew 

Ruhe 
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Konsonanten (Mitlaute) 


Code 

Beispiele 


Code 

Beispiele 



englisch 

deutsch 


englisch 

deutsch 

R 

red 


L 

yellow 

Kelle 

W 

away 


Y 

yellow 

Jugend 

M 

men 

Mann 

N 

men 

Kahn 

NX 

sing 

Ring 

SH 

rush 

waschen 

S 

sail 

Rost 

TH 

thin 


F 

fed 

Futter 

ZH 

pleasure 

Mensch 

Z 

has 

Hase 

DH 

then 


V 

very 

Wein 

J 

judge 


CH 

check 

Tschako 

/C 

loch 

Loch 

/H 

hole 

Hund 

P 

put 

Papier 

B 

but 

Butter 

T 

toy 

Turm 

D 

dog 

Dame 

G 

gueest 

Gast 

K 

Commodore 

Kuchen 
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Spezielle Symbole 


Code 

Beispiele 

englisch 

deutsch 

Bemerkungen 

DX 

pity 

Ratte 

Zugenstoßlaut 

Q 

kitt_en 

Platt_en 

Stimmritzen-Stop 

QX 

pause 


stimmloser Vokal 

RX 

car 

Haar 

stimmloser Konsonant 

LX 

call 

hohl 

stimmloser Konsonant 

UL 

wie AXL 


Kontraktion (s. Kap. H.3) 

UM 

wie AXM 


Kontraktion (s. Kap. H.3) 

UN 

wie AXN 


Kontraktion (s. Kap. H.3) 

IL 

wie IXL 


Kontraktion (s. Kap. H.3) 

IM 

wie IXM 


Kontraktion (s. Kap. H.3) 

IN 

wie IXN 


Kontraktion (s. Kap. H.3) 


1 Silbenbetonung im Bereich zwischen 

Sekundär- und emphatischer Betonung 


9 

? 


0 


Punkt. Satzende-Markierung 
Fragezeichen. Satzende-Markierung 
Gedankenstrich. Phrasen-Trennzeichen 
Komma. Nebensatz-Trennzeichen 
Klammern. Hauptphrasen - Trennzeichen 
(s. Kap. H.8) 




fr 

Commodore 


